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

Subheading

Link

OpenAPI

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