By default, Doctave will include all your pages in the left-side navigation and sort them in
alphanumerical order. But sometimes you will want to customize either the order or the content of
the navigation. This is why you can set the contents of the navigation in the
This allows you to:
As an example, below is this site's navigation config:
navigation: - path: docs/installing.md - path: docs/tutorial.md - path: docs/features children: "*" - path: docs/configuration.md - path: docs/contributors children: "*"
navigation key expects a list of maps that describe a page, and any child pages. You can read
the above example as saying "first include the installing page, then the tutorial page, then the
features directory and include all pages, next the configuration page, and finally the contributors
directory and all its children."
The order in which links are included will be preserved in the navigation.
In the simplest case, you can include a single page like so:
navigation: - path: docs/tutorial.md
When including a directory, you have 3 options:
navigation: - path: docs/runbooks
navigation: - path: docs/runbooks children: - path: docs/runbooks/deployment.md
navigation: - path: docs/runbooks children: "*"
Note that the asterisk character has to be quoted in order to appease the YAML parser.
Powered by Doctave