Awesome nav demo

Documentation

These docs show how jekyll-awesome-nav turns a normal folder of Markdown files into navigation data your layouts can render.

The plugin does not require collections. It reads pages under the configured awesome_nav.root, builds a tree, and writes the result onto each docs page.

Start here

Folder shape

This documentation site uses a plain docs/ folder:

docs/
├── index.md
├── getting-started.md
└── guides/
    ├── index.md
    ├── install.md
    ├── layouts.md
    ├── nav-file.md
    ├── overrides.md
    ├── data.md
    ├── config.md
    └── .nav.yml

Pages are included in the generated tree when they live under awesome_nav.root. A folder can provide an index.md page to represent the section itself.

Plugin data Resolved page variables for this page

page.breadcrumbs

[{"title":"Documentation","url":"/docs/"}]

page.awesome_nav

[{"title":"Guides","url":"/docs/guides/","children":[{"title":"Install Guide","url":"/docs/guides/install/","current":false,"contains_current":false},{"title":"Layout Integration","url":"/docs/guides/layouts/","current":false,"contains_current":false},{"title":"Configuration","url":"/docs/guides/config/","current":false,"contains_current":false},{"title":".nav.yml Reference","url":"/docs/guides/nav-file/","current":false,"contains_current":false},{"title":"Navigation Overrides","url":"/docs/guides/overrides/","current":false,"contains_current":false},{"title":"Generated Data","url":"/docs/guides/data/","current":false,"contains_current":false}],"current":false,"contains_current":false},{"title":"Getting Started","url":"/docs/getting-started/","current":false,"contains_current":false}]

page.awesome_nav_local

[{"title":"Guides","url":"/docs/guides/","children":[{"title":"Install Guide","url":"/docs/guides/install/"},{"title":"Layout Integration","url":"/docs/guides/layouts/"},{"title":"Configuration","url":"/docs/guides/config/"},{"title":".nav.yml Reference","url":"/docs/guides/nav-file/"},{"title":"Navigation Overrides","url":"/docs/guides/overrides/"},{"title":"Generated Data","url":"/docs/guides/data/"}]},{"title":"Getting Started","url":"/docs/getting-started/"}]

page.awesome_nav_dir

"docs"

page.awesome_nav_previous

null

page.awesome_nav_next

{"title":"Guides","url":"/docs/guides/"}