Skip to content

Files

website

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Dec 9, 2024
Jan 9, 2024
Dec 30, 2022
Jan 9, 2024
Oct 4, 2022
Oct 9, 2022
Oct 4, 2022
Oct 9, 2022
Nov 30, 2023
Jan 22, 2024
Oct 4, 2022
Jan 22, 2024
Oct 4, 2022
Jan 10, 2025
Oct 11, 2022

Error Prone Support website

This directory contains the majority of the source code that powers error-prone.picnic.tech. The website is statically generated using Jekyll.

Local development

To view the website on localhost, first follow the Jekyll installation instructions. Once done, in this directory execute:

bundle install
../generate-docs.sh && bundle exec jekyll serve --livereload

The website will now be available on port 4000. Source code modifications (including the result of rerunning ../generate-docs.sh) will automatically be reflected. (An exception is _config.yml: changes to this file require a server restart.) Subsequent server restarts do not require running bundle install, unless Gemfile has been updated in the interim.

If you are not familiar with Jekyll, be sure to check out its documentation. It is recommended to follow the provided step-by-step tutorial.

We use the Just the Docs Jekyll theme, which also includes several configuration options.

Switch Ruby versions

The required Ruby version is set in .ruby-version. To switch, you can use rvm to manage your Ruby version.

Resolve Bundler issues

On macOS, you may get an error such as the following when running bundle install:

fatal error: 'openssl/ssl.h' file not found

In that case, run:

bundle config build.eventmachine --with-cppflags="-I$(brew --prefix openssl)/include"
bundle install

Deployment

The website is regenerated and deployed using the deploy-website.yml GitHub Actions workflow any time a change is merged to master.