Editing navigation
When adding new pages to your documentation, you'll need to link them at some place in the navigation menu.
By default, the left-hand-side navigation of your documentation site is
defined in the src/navigation.json
file. Currently, only
two-level navigation is supported.
The navigation JSON file groups pages (articles) in your site into chapters:
{
"chapters": [
{
"title": "Getting started",
"articles": [
"getting-started",
"quick-start"
]
},
{
"title": "Basic usage",
"articles": [
"editing-navigation",
"editing-pages",
"code-blocks",
"customization"
]
},
{
"title": "Advanced topics",
"articles": [
"under-the-hood",
"configuration-reference"
]
}
]
}
The articles
array lists identifiers of pages to link to the
specific chapter. An identifier of getting-started
, for
example, will be mapped to content/getting-started.html
.
Please note that a page will not appear in the menu until you create its corresponding HTML file. A warning will be logged to DevTools console.