{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/developer-portal/configuration/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Configuration

\n

This page describes how to organize the files and folders and how to configure the look and feel of the Portal.

\n
\n

Overview

\n

To start working with Redocly Portal, please get familiar with the following:

\n\n

Organizing content

\n

Folders

\n

The following special folders will be created automatically within your project:

\n
    \n
  1. \nimages\n/ – you can keep your images in this folder.\n
    2. \n
  2. \nnode_modules\n/ – do not remove or modify the contents of this folder. It contains the software library dependencies.\n
    3. \n
\n

We recommend creating folders based on your content, and then organizing the content within one root folder:

\n
\n
\n
Copy
\n
Copied
\n
\n 
[_folder_name_]/
\n
\n

Important: The folder naming influences the URL paths of the published website.

\n

File types

\n

Markdown files

\n

A regular Markdown file ends with a .md file extension. Use regular Markdown files when your content doesn't require any special components.

\n

MDX files

\n

An MDX extension file ends with a .mdx file extension. Learn more about using MDX here.

\n

Special files

\n

The following files must be kept at the top level of the project structure.\nIf needed, you can change the contents of these files to configure look and feel of the Portal.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FileDescription
index.mdxThe home page of the Portal.
siteConfig.yamlIn this file, you can do the following:
  • Set up persistent navigation and logo.
  • Declare API definitions and stylesheets.
  • Add custom scripts.
  • Set up google analytics.
theme.tsControls the fonts and colors used throughout the Portal.
sidebars.yamlControls the sidebar navigation among contents.
favicon.pngDisplays the favicon.
\n

For more details, see Customizing Portal.

\n

Also, you can include your OpenAPI .yaml or .json file directly in the Portal to be able to generate the API reference pages.

\n

For more details, see Integrating API Reference.

","headings":[{"value":"Configuration","depth":1},{"value":"Overview","depth":2},{"value":"Organizing content","depth":2},{"value":"Folders","depth":3},{"value":"File types","depth":3}]},"contentItem":{"data":{"lastModified":"2023-03-21T02:46:22.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"48c19c25-8c5b-51d9-9946-1487df4140ce__redocly content/developer-portal/configuration/","seo":{"title":"Configuration","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"developer-portal/configuration.md","pageBaseUrl":"/developer-portal/configuration","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Configuration","id":"configuration"},{"depth":2,"value":"Overview","id":"overview"},{"depth":2,"value":"Organizing content","id":"organizing-content"},{"depth":3,"value":"Folders","id":"folders"},{"depth":3,"value":"File types","id":"file-types"}]},"data":{"title":"Configuration"},"catalogInfo":null,"link":"/developer-portal/configuration/","sidebarName":"","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}