🚧 WIP 🚧 Zilker Jekyll Theme
Zilker is a work-in-progress Jekyll theme for City of Austin websites.
Add this line to your Jekyll site's
gem "jekyll-theme-zilker", github: "cityofaustin/zilker-theme"
And add this line to your Jekyll site's
And then execute:
The primary "global" navigation (in the site header) is set in _data/labels.yaml in the list starting with
site_nav:. Check to make sure your links exist, and please don't use too many items in this list. Use relative links that begin at the site root.
Zilker generates the sidebar navigation automatically, with zero configuration.
Pages in subfolders, like
example-folder/parent/child.md, render as visual children of their parent, e.g.
example-folder/parent.md. The parent page must exist for the child page to appear in the navigation. If you want a section header without creating an actual parent page, use
layout: redirect in the section/parent's markdown file and specify where that url should redirect to:
layout: redirect redirect_to: "/example-folder/parent/child"
The navigation logic is recursive, and works with deeply nested children, but exceeding two levels is not recommended.
Zilker also supports per-section sub-navigation using Jekyll Collections. Given a collection named
examplecollection, each document in _examplecollection/ will include navigation to the other documents in the collection when output.
Sorting and parent-child relationships work the same way in a collection's sub-navigation as in the primary navigation.