Navigation

Create explicit or generated documentation navigation.

Without a navigation file, M-Press creates a deterministic navigation tree from the discovered pages. For a curated manual, add _nav.yaml to the content root.

- label: Home
  link: /
- label: Get started
  items:
    - label: Installation
      link: /installation/
    - label: Configuration
      link: /configuration/
- label: API
  collapsed: true
  autogenerate:
    directory: reference
- label: GitHub
  link: https://github.com/example/project

Items may be links, nested groups, or autogenerated directories. Set collapsed: true when a group should be closed initially.

Strict builds validate every internal navigation link against the default language or the current translation. External HTTP links are left untouched.

For translated navigation, place another _nav.yaml inside the language directory. For example, use content/fr/_nav.yaml. If it is absent, M-Press uses the default navigation and routes available translated pages appropriately.