Solace theme for Jekyll
- Lightweight, streamlined design. Eliminate distractions. Let the reader focus on your content.
- Focus on blog content, with clean and easy support for other page types.
- Easy to customize all functionality and styling.
- Simple, clean design that's responsive, mobile-friendly, and easily customizable.
- Intuitive blog presentation and navigation.
- Automatic inclusion of new pages in main navigation.
- Featured categories for blog content in main navigation.
- Easily extended Sass modules, so you can customize the look & feel.
- Available as a theme gem for GitHub Pages.
- Provides easy defaults for all packaged Jekyll features in GitHub Pages.
Installation for GitHub Pages
For new sites:
gem "jekyll-remote-theme"to your
Gemfileto track the dependency.
- Copy this project's _config.yml to your site.
- Uncomment line 6 in your site's copy of
index.htmland remove its
bundle exec jekyll serveto build and serve your site.
For existing sites, the following parts of _config.yml should be copied:
remote_theme(commented out in default, must be uncommented)
All of these settings should be customizable as you see fit, however the theme code expects/requires them to be present.
Creating the Home Page
By default, this theme supports
jekyll-readme-index, so the homepage can be generated from an undecorated
README.md file (such as this). This does not provide the recommended blog reading experience.
If you wish to provide your own home page, you can start by copying
index.html. This page relies on the home layout, which provides the three most-recent blog posts.
Creating the Blog Index Pages
This theme creates several pages that are structured to group posts by tag, category, and author.
The site's front-end code automatically filters those pages when an associated anchor is used (e.g.
First, you should probably copy these pages out of the theme's source:
Adding Pages in the Navigation menu
By default, all pages in the
pages directory get listed in the navigation menu.
This theme allows for pages to be excluded by adding a property to their frontmatter,
These pages will still be rendered, navigable by search engines, etc, but they will be excluded from the main navigation menu.
An example of disabling the listing of a specific page is provided at:
- Jekyll basically distinguishes
postsby their origin in
_postsdirectory. Posts are not included in the menu.
jekyll-readme-indexdoes not render
index.htmlcorrectly when the
README.md. Seemingly, this may be due to
jekyll-optional-front-matterconverting it to