betterplace-content

Jekyll theme for betterplace content pages.

Installation

Add this line to your Jekyll site's Gemfile:

gem "betterplace-content"

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

theme: betterplace-content

And then execute:

$ bundle

Development

To set up your environment to develop this theme, run the script/bootstrap script. Note that this will check out all betterplace content repositories and install their bundles.

The installation script will ask you for a personal github access token with repo access. Instructions: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token. Afterwards provide this token when the script asks for it, or add it to GITHUB_TOKEN file (ignored by git).

Your theme is setup just like a normal Jekyll site! To test your theme, run bundle exec jekyll serve and open your browser at http://localhost:4000. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.

When your theme is released, only the files in _layouts, _includes, and _sass tracked with Git will be released.

Helpers

Since this theme is used in all betterplace content pages, there are a number of scripts in scripts to make things a little easier. Read the comments in those scripts to find out what they do.

Release a new version: scripts/release-theme

You can run script/release-theme to attempt an automated update of everything. This will

  • Bump the version number of the theme
  • Release the theme to rubygems.org
  • Wait for it to appear
  • Attempt to update all "content" repositories to use the new theme

The last step can easily fail. If it does, you can safely re-run script/update-dependencies as often as you like. Do not re-run the release script after the gem was released, or you'll create a new version on github every time.

License

'content--theme' is released under the Apache-2.0 license, Copyright 2017..2022 gut.org gAG.