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
- Getting Started shows the minimum install and config.
- Layout Integration shows how to render sidebars, breadcrumbs, and previous/next links.
- Configuration explains the available plugin settings.
- .nav.yml Reference documents override syntax, options, and common patterns.
-
Navigation Overrides shows how local
.nav.ymlfiles customize sections. - Generated Data lists the page variables available to themes and layouts.
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.