Navigation File Reference

The navigation for a project is configured in navigation.yaml files. This is the navigation you see on the left side of the screen (or in the mobile navigation if on a mobile device).

Each tab or subtab has a corresponding navigation.yaml file.

For usage and examples, see sidebar navigation.

Configuration Example

An example navigation.yaml demonstrating the available configuration options.

---
- heading: Introduction
  items:
  - label: What is Doctave?
    href: /introduction/what-is-doctave.md
  - label: Doctave Dashboard
    external: https://dashboard.doctave.com

- heading: Projects
  items: 
  - label: Basics
    href: /projects/basics.md
  - label: Settings
    href: /projects/settings.md
    items:
    - label: Look and Feel
      href: /projects/settings/look-and-feel.md
    - label: Content Filters
      href: /projects/content-filtering-with-user-preferences.md
  - label: Pages
    href: /projects/pages.md
  - label: Domains
    href: /projects/domains.md

- heading: Reference
  items:
  - label: Configration Files
    href: /docs/reference/configuration-files.md
    items:
    - label: Project
      href: /docs/reference/doctave-yaml.md
    - label: Navigation
      href: /docs/reference/navigation-yaml.md

- heading: API Reference
  items:
  - open_api_spec: http_spec.json

Reference

Below are explanations of all the objects and their fields in the navigation structure. Your navigation.yaml should contain a list of these objects.

Heading

field description required? default
heading The title of the section false
collapsed Should the list of children be collapsed false false
collapsible Can the list of children be collapsed (true, if collapsed is set) false false
items List of Links, Subheadings or OpenAPI navigation objects false []
show_if See content filters false

Subheading

field description required? default
subheading Text to display for the subheading true
collapsed Should the list of children be collapsed false false
collapsible Can the list of children be collapsed (true, if collapsed is set) false false
items List of Links, Subheadings false []
show_if See content filters false

Link

field description required? default
label Text to display for the link true
href Page the link should point to. false*
external External page the link should point to. false*
collapsed Should the list of children be collapsed false false
collapsible Can the list of children be collapsed (true, if collapsed is set) false false
items List of Links, Subheadings false []
show_if See content filters false

*You must specify either external or href for a link

OpenAPI

The open_api_spec expands your API definition into navigation sections based on your OpenAPI tags.

field description required? default
open_api_spec The path to the OpenAPI spec in your project. Must be mentioned in your doctave.yaml file true
only Limit which OpenAPI tag pages to include links for. See filtering tags false
show_if See content filters false

Was this page helpful?