labrea

labrea

A simple Jekyll theme for keeping journals

labrea

A Jekyll theme based on Ace with only minor modifications.

Installation

Add this to your Jekyll site's Gemfile:

gem "labrea-theme"
gem "jekyll-paginate" # if you want pagination enabled

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

theme: labrea-theme

and ensure you have jekyll-paginate listed under gems in your _config.yaml:

plugins:
  - jekyl-paginate

And then execute:

$ bundle

Or install it yourself as:

$ gem install labrea

Usage

Navigation links are displayed below the heading. The default is a list of all pages in the site. You can customise this by adding something along the following lines to your _config.yaml:

header_pages:
  - about.md
  - portfolio.md

This functionality is copied from the minima theme

Custom CSS

If you would like to add custom CSS, create a file /assets/css/main.scss and add

---
---

@import "ace";

at the beginning and place your custom code below.

No indexing

The theme also comes with the possibility to stop search engines from indexing your site. If noindexing: true is added to your _config.yaml, the line

<meta name="robots" content="noindex,nofollow">

is added to the header of every page.

This theme has included a minimal lightbox. All image and video links open in a lightbox. To prevent this behaviour on any specific link add the css class .no-lightbox. In markdown this is achieved in the following way

[link text](/link/address){:.no-lightbox}

Image galleries

This theme has included support for image galleries. Please read the information in that link before using, in particular images are resized and hosted by a third party. To insert a gallery into a post, create a directory in /assets/images/ with the same name as your post and place your jpg images here. Place your post in a directory with the same name. Then insert

{% include image-gallery.html folder="." %}

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/noaham/hello. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The theme is available as open source under the terms of the MIT License.