Getting Started

Add the gem to your Jekyll site and enable it in _config.yml.

Install the gem

gem "jekyll-awesome-nav"

Then install your bundle:

bundle install

Enable the plugin

plugins:
  - jekyll-awesome-nav

awesome_nav:
  enabled: true
  root: docs
  nav_filename: _nav.yml

Add docs pages

Create Markdown files under the configured root:

docs/
├── index.md
├── getting-started.md
└── guides/
    ├── index.md
    └── install.md

Each page should have a title:

---
title: Install
---

Install instructions go here.

The plugin builds navigation from these pages during the normal Jekyll build. Your layout can then render page.awesome_nav, page.breadcrumbs, and the previous/next links.

Render it

If your theme already supports jekyll-awesome-nav, choose that docs layout for pages under your docs root. This demo uses the theme’s docs layout through defaults:

defaults:
  - scope:
      path: "docs"
    values:
      layout: docs

If your theme does not support it yet, use the examples in Layout Integration to wire the data into your own layout.