🥁 A really basic theme for Jekyll, using the official Jekyll theme implementation.
To give you a running start I've put together some starter kits that you can download, fork or even deploy immediately:
gem "garth-jekyll-theme"
to your Gemfile
to add the theme as a dependancybundle install
in the root of project to install the theme and its dependanciestheme: garth-jekyll-theme
to your _config.yml
file to set the site themebundle exec jekyll serve
to build and serve your site_config.yml
file to set site-wide optionsgem "jekyll-remote-theme"
to your Gemfile
to add the theme as a dependancybundle install
in the root of project to install the jekyll remote theme gem as a dependancyjekyll-remote-theme
to the list of plugins
in your _config.yml
fileremote_theme: daviddarnes/garth
to your _config.yml
file to set the site themebundle exec jekyll serve
to build and serve your site_config.yml
file to set site-wide options(deprecated, not recommended)
Gemfile
with one stating all the gems used in your projectCODE_OF_CONDUCT.md
, CONTRIBUTING.md
, LICENSE
, screenshot.png
, CNAME
and garth-jekyll-theme.gemspec
bundle install
in the root of project to install the jekyll remote theme gem as a dependancybundle exec jekyll serve
to build and serve your site_config.yml
file to set site-wide optionsWhen using Garth as a theme means you can take advantage of the file overriding method. This allows you to overwrite any file in this theme with your own custom file, by matching the file name and path. The most common example of this would be if you want to add your own styles or change the core style settings.
To add your own styles copy the styles.scss
into your own project with the same file path (assets/styles.scss
). From there you can add your own styles, you can even optionally ignore the theme styles by removing the @import "garth";
line.
If you're looking to set your own colours copy the _colors.scss
and main theme styles file garth.scss
into your project at the same file path (_sass/
) and change variables however you wish. The settings are a mixture of custom variables and settings from Sassline - follow the link to find out how to configure the typographic settings.
You'll need to change the description
, title
and url
to match with the project.
There are 3 layouts; page
, post
and home
(home acts as the font page blog).
Note: The Post List Page options are actually in the collection data within the
_config.yml
file, this is so they can be edited with CMSs such as Siteleaf