This is a Jekyll site built to run as a Github pages Organization Pages site:
Content from the master branch will be used to build and publish your GitHub Pages site.
This typically takes a few seconds after a commit is pushed.
Information for writers
Jekyll docs: https://jekyllrb.com/docs/posts/
FontAwesome cheat cheet: http://fontawesome.io/cheatsheet/
Information for developers
This is forked from https://github.com/mmistakes/minimal-mistakes
Github repo settings have "blogs.lookinglocal.gov.uk" as the Custom Domain.
To make SSL work (important for trust) there is a Cloudfront distribution with *.lookinglocal.gov.uk SSL cert attached, whose important settings are:
- Alternate Domain Names: blogs.lookinglocal.gov.uk
- Origin Domain Name: lookinglocal.github.io
- Origin Protocol Policy: HTTP only
- Viewer Protocol Policy: Redirect HTTP to HTTPS
- Allowed HTTP Methods: GET, HEAD, OPTIONS
- Whitelist the
Hostheader (this is important in conjunction with Github repo custom domain)
- Object Caching: Customize (this is important as Github Pages caches for 10 mins)
- Minimum TTL: 0
- Maximum TTL: 0
- Default TTL: 0
- Forward Cookies: All (don't know if this is important)
- Query String Forwarding and Caching: None
- Compress Objects Automatically: Yes
To run locally with Jekyll
Install dependencies using Bundler:
$ bundle install
On Mac OS Sierra you may need to do something like this first:
$ xcode-select --install
$ bundle config build.nokogiri --use-system-libraries --with-xml2-include=$(brew --prefix libxml2)/include/libxml2
$ bundle exec jekyll serve --safe
Or using overrides for local config
$ bundle exec jekyll serve -w --verbose -c _config.yml,_config.dev.yml --drafts
Keeping your local server up to date with the GitHub Pages gem
Jekyll is an active open source project and is updated frequently. As the GitHub Pages server is updated, the software on your computer may become out of date, resulting in your site appearing different locally from how it looks when published on GitHub.
$ bundle update github-pagesor simply
$ bundle updateand all your gems will update to the latest versions.
If you don't have Bundler installed, run gem update github-pages
GitHub Pages dependencies
If you want to find out versions of underlying components in GitHub Pages (e.g. Liquid templating engine), see:
Liquid templating engine
Unfortunately the Liquid documentation isn't version-specific.