Lanyon includes some customizable options, typically applied via classes on the
Create a list of nav links in the sidebar by assigning each Jekyll page the correct layout in the page’s front-matter.
--- layout: page title: About ---
Why require a specific layout? Jekyll will return all pages, including the
atom.xml, and with an alphabetical sort order. To ensure the first link is Home, we exclude the
index.html page from this list by specifying the
Lanyon ships with eight optional themes based on the base16 color scheme. Apply a theme to change the color scheme (mostly applies to sidebar and links).
There are eight themes available at this time.
To use a theme, add any one of the available theme classes to the
<body> element in the
default.html layout, like so:
<body class="theme-base-08"> ... </body>
To create your own theme, look to the Themes section of included CSS file. Copy any existing theme (they’re only a few lines of CSS), rename it, and change the provided colors.
Reverse the page orientation with a single class.
<body class="layout-reverse"> ... </body>
Make the sidebar overlap the viewport content with a single class:
<body class="sidebar-overlay"> ... </body>
This will keep the content stationary and slide in the sidebar over the side content. It also adds a
box-shadow based outline to the toggle for contrast against backgrounds, as well as a
box-shadow on the sidebar for depth.
It’s also available for a reversed layout when you add both classes:
<body class="layout-reverse sidebar-overlay"> ... </body>
Show an open sidebar on page load by modifying the
<input> tag within the
sidebar.html layout to add the
checked boolean attribute:
<input type="checkbox" class="sidebar-checkbox" id="sidebar-checkbox" checked>
Using Liquid you can also conditionally show the sidebar open on a per-page basis. For example, here’s how you could have it open on the homepage only:
<input type="checkbox" class="sidebar-checkbox" id="sidebar-checkbox" >
Lanyon has two branches, but only one is used for active development.
masterfor development. All pull requests should be to submitted against
gh-pagesfor our hosted site, which includes our analytics tracking code. Please avoid using this branch.
Open sourced under the MIT license.