Lanyon is an unassuming Jekyll theme that places content first by tucking away navigation in a hidden drawer. It's based on Poole, the Jekyll butler.
Lanyon is a theme built on top of Poole, which provides a fully furnished Jekyll setup—just download and start the Jekyll server. See the Poole usage guidelines for how to install and use Jekyll.
Lanyon includes some customizable options, typically applied via classes on the <body>
element.
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 page
layout.
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" {% if page.title =="Home" %}checked{% endif %}>
Create tags with _tools/createTag url-name "Pretty Name"
. Tag posts by adding tags: [tag-name]
to the front matter of post files.
For example:
$ ./_tools/createTag "Using git"
Note: This script converts the pretty name you specify (e.g. Using git) into a simple slug name (e.g. using-git
), with these side effects:
- all capitalized characters are converted to lowercase
- all symbols (other then numbers and letters) are replaced with dashes
-
---
layout: post
title: How to clone a repository
tags: [using-git, documentation]
---
See the [GitHub topic](https://help.github.com/articles/fork-a-repo/). It's pretty good.
$ git add _data/tags.yml
$ git add tag/using-git.md
$ git add _posts/2014-12-31-how-to-clone-a-repository.md
$ git commit -m "Add new tag and post"
$ git push
If you're reading this section, you probably want to use the upstream-wishlist
branch for your GitHub Pages site. Here's how to use it:
- Clone
wireddown/wireddown.github.io
(GitHub help)- or if you want to be able to pull updates, fork instead (GitHub help)
- Delete the
gh-pages
branch -- we'll be replacing it next (GitHub help) - Switch to the
upstream-wishlist
branch - Create a branch named
gh-pages
- Personalize for your site
Lanyon has two branches, but only one is used for active development.
master
for development. All pull requests should be to submitted againstmaster
.gh-pages
for our hosted site, which includes our analytics tracking code. Please avoid using this branch.
Mark Otto
Open sourced under the MIT license.
<3