No release in over a year
A Jekyll theme for Coffee Brew Apps documentation.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 4.0, < 5.0
~> 0.18.0
~> 13.0.6
 Project Readme

Coffeebrew Jekyll Theme

A Jekyll theme for documentation.

Gem Version

Installation

Add this line to your site's Gemfile:

gem 'coffeebrew_jekyll_docs'

Configuration

To use the theme properly, you need to configure in _config.yml:

baseurl: /your_base_url
theme: coffeebrew_jekyll_docs

# The theme uses the jekyll-toc plugin to render table of contents for your content
plugins:
  - jekyll-toc

# Configure the plugin, see https://github.com/toshimaru/jekyll-toc
toc:

# Here's the config for the theme used by this gem doc
coffeebrew_jekyll_docs:
  copyright: "Coffee Brew Apps"
  license:
    name: "MIT License"
    url: "/license.html"
  socials:
    - link: "https://github.com/coffeebrewapps/coffeebrew_jekyll_docs"
      icon: "fa-brands fa-github"
    - link: "https://www.linkedin.com/company/coffeebrewapps/"
      icon: "fa-brands fa-linkedin"
    - link: "mailto:coffeebrewapps+hi@gmail.com"
      icon: "fa-solid fa-envelope"
  powered_by:
    host:
      link: "https://github.com"
      name: "Github Pages"

# This allows for your changelog to be versioned
collections:
  versions:
    output: true

# Add this to the defaults in addition to your other defaults
defaults:
  - scope:
      path: ""
      type: "versions"
    values:
      layout: version

Additionally, create the navigation data in _data/navigation.yml so that the theme can render the top navbar:

- name: Home
  link: /
- name: Versions
  link: /versions.html

You can of course add more links to the navigation.

Upon building the Jekyll site, the theme should be used to render your content.

License

See the LICENSE file.