summoner-jekyll-theme

My Jekyll theme for my personal blog, https://summoning.net, designed to be simple and minimal.

Installation

Add this line to your Jekyll site's Gemfile:

gem "summoner-jekyll-theme"

And add this line to your Jekyll site's _config.yml:

theme: summoner-jekyll-theme

If you're using the github-pages gem, use remote_theme in _config.yml intead:

remote_theme: pinecat/summoner-jekyll-theme

And then execute:

$ bundle

Or install it yourself as:

$ gem install summoner-jekyll-theme

Usage

Layouts

  • 404.html: Default 404 page with SMT imagery, set permalink if using pretty links
  • archive.html: List tag types based on jekyll-archives tags
  • blog.html: Post listings, pagination supported via jekyll-paginate-v2
  • default.html: Minimum layout necessary for including CSS and JS
  • index.html: Homepage with SMT imagery and navigation
  • page.html: Use for miscellaneous pages (about, contact, etc.)
  • post.html: Use for blog posts

Misc.

  • The theme supports jekyll-feed, default link is to /blog/feed.xml
  • It is expected for the homepage to mostly be a set of links to other areas on the site. Use of the .nav class is recommended to wrap your links in: html <div class="nav"> <a href="/blog">blog</a> <a href="/blog/feed.xml">rss</a> </div> <div class="nav"> <a href="#">about</a> <a href="#">archive</a> </div>

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/pinecat/summoner-jekyll-theme.

Development

git clone https://github.com/pinecat/summoner-jekyll-theme
cd summoner-jekyll-theme
bundle

License

The theme is available as open source under the terms of the MIT License. The fonts shipped with the theme are all under the OFL, and a copy of each font's license can be found in the _data directory.