Navigation File Reference

The navigation for a project is configured innavigation.yaml.

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

- 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: /reference/configuration-files.md
    items:
    - label: Project
      href: /reference/doctave-yaml.md
    - label: Navigation
      href: /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. 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

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
show_if See content filters false

Was this page helpful?