nav-links provide a navigation bar at the top of your page. This is a nice way to tie together several related pages, without affecting the site-wide side menu.

nav-links are enabled in the front matter of a page. Simply turning them on with a true value will automatically link to all pages in the same directory:

---
---


By default, pages will appear in the navigation section using their title. If desired, this can be overridden using the nav-title front matter:

---
nav-title: Navigating the Site
---


For more control over the links, you can also manually specify a list of pages to link to, and the title to give each page:

---
- title: Overview
url: /develop/index
- title: Philosophy
url: /develop/philosophy
- title: Source code
url: /develop/source
---


Changes to the navigation menu affect all pages. Items should be reserved for general topics.

The navigation menu allows hierarchical organization of wiki topics. Items are added to the menu by editing the menu include and creating a new <li> element as appropriate:

In the linked page itself, we add a section entry in the front matter to indicate what section of the menu should be opened by default when navigating to that page. Note that the sections only need to be specified to the containing section: for example, in this page:

---