Simple way to dynamically manage documentation through front matter without the need for a pesky config file.
Three variables one can set in front matter:
parent
: Represents if this should be nested within another page for navigationhidden
:false
for a page to be publicly listed, it'll be accessible via direct link regardlessnav_priority
: Weights which document to show first, 1 is highest (ie top)
- Can default to hide/show everything within
_config.yml
- A page shows up as a header if it:
- has no parent OR
- is a parent page
- If a page has a parent, it will show up underneath the parent
- Can only have 2 levels
- If a parent is hidden, then all child pages are also hidden
- Weighting can be defaulted for documents in
_config.yml
to100
to keep them at the bottom, or1
for at top