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.