No commit activity in last 3 years
No release in over 3 years
A simple and minimal project page theme for Jekyll.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.12
~> 10.0

Runtime

~> 3.3
 Project Readme

Black White Blue

Gem Version

Black White Blue is a simple and minimal project page theme for Jekyll, which is designed to build project pages in an easier way.

Black, white and blue are the colors used in the page. White for background, black for text and blue for links.

Installation

Add to your Jekyll site's Gemfile:

gem "black-white-blue"

And add this line to your _config.yml:

theme: black-white-blue

Then execute:

$ bundle install

Usecase

Usage

Project Metadata

Project metadata is defined in _config.yml:

project:
  name: "Black White Blue"
  subtitle: "A simple and minimal project page theme for Jekyll."
  description: |-
    Black White Blue is a simple project page theme for Jekyll, which is designed to build project pages in a easier way.
    Black, white and blue are the colors used in the page. White for background, black for text and blue for links.
  repo: "crispgm/black-white-blue"
  logo: "/black-white-blue/assets/logo.png"
  author: "David Zhang"
  author_link: "https://crispgm.com/"
  email: crispgm@gmail.com
  twitter: crispgm
  medium: "@crispgm"

Email/Twitter/Medium is optional, which will be shown as icons on the bottom right.

Changelog

Changelog is maintained in _data/changelog.yml.

For a version, simply add an yaml array item:

- version: "1.0.1"
  changes:
    - text: Performance improved
      hash: 3325193
- version: "1.0.1"
  changes:
    - text: Bugfix
      issue: 12
- version: "1.0.0"
  changes:
    - text: "Initial version"

Each version comes with multiple changes, and you may present a text with an issue ID. It will generate a link to the GitHub issue specified.

Google Analytics

Edit _config.yml and set your track_id:

google_analytics: UA-XXXXXXXX-1

Disqus

Init Disqus with your short name in _config.yml:

disqus:
  shortname: your-short-name

Then, enable Disqus in pages by adding frontmatter:

---
layout: page
title: Disqus Example
comments: true
---

Contributing

  • Black White Blue is licensed under MIT License.
  • If there is a bug, you may file an issue or pull request directly.
  • Pull requests for contribution is welcomed.