Blue
Minimalist Jekyll theme based on Bulma.
This work is on active development, but currently suitable for use on production and GitHub pages.
What does comes with Blue?
Blue comes with the following features:
- Bulma CSS library.
- Kramdown as Markdown engine.
- MathJax for LaTeX-math support.
- Syntax highlight built-in.
- Pagination (via
jekyll-paginaterubygem). - Search engine optimization (via
jekyll-seo-tagrubygem). - RSS support by default (via
jekyll-feedrubygem).
Installation (GitHub Pages)
- Fork this repository.
- Rename your fork as
your-username*.github.io - Edit the variables on
_config.ymlto make them yours. - Replace the content of
_posts/with your own content. - Enjoy and submit me any issue or improvement!
Installation (using RubyGems)
-
Add
blue-jekyll-themeto yourGemfile. -
Update your gems.
$ bundle update -
Update your
_config.ymlfile, replace your current theme byblue-jekyll-themeand add the needed plugins:jekyll-paginatejekyll-seo-tagjekyll-feed
Config variables
Add or remove variables from the sample config file.
Available colors are the same for Bulma (default ones). You can choose between primary (light turquoise), info (blue), warning (yellow), danger(red), dark (black) and light (default). It will switch the header color.
# Permalinks
permalink: pretty
# Setup
title: My Site
subtitle: My fancy site.
baseurl:
url: "https://example.dev"
color: danger
author:
name: Jhon Doe
url: http://example.dev
email: # Place your email here
github: JohnDoe # Place your GitHub username here
twitter: JohnDoe # Place your twitter username here
mastodon: https://instance.dev/@johndoe # Place your profile URL here
# Assets
sass:
style: compressed
markdown: kramdown
highlighter: rouge
kramdown:
input: GFM
# Custom vars
version: 3.8.5
paginate: 5 # Default pagination is 5 post per page
paginate_path: "/page:num/" # Default route for pages
plugins:
- jekyll-paginate
- jekyll-seo-tag
Licencse
MIT License