Uses the Nanoc static website generator.
Nanoc requires Ruby to run. Nanoc supports the official Ruby interpreter from version 2.3 up.
Ruby may already be installed on your system. To check, open a terminal window and type ruby -v. To install Ruby, follow the installation instructions on the Ruby website.
You need to run Nanoc with Bundler. To avoid permission errors1 it is recommended to use the --user install option when installing gems.
To install bundler, type gem install bundler --user install in a terminal to install Bundler to a directory inside your home directory. To use Bundler or any other gem installed to your ~/.gem directory, you need to add ~/.gem/ruby/version/bin to your PATH environment variable. If you use bash, add the following lines to your ~/.bashrc2:
# Ruby user installed gems
if which ruby >/dev/null && which gem >/dev/null; then
PATH="$(ruby -r rubygems -e 'puts Gem.user_dir')/bin:$PATH"
fiOpen the repository directory and type bundle install --path vendor/bundle to install the local dependencies.
Use bundle exec nanoc compile and bundle exec nanoc view to generate and host a static preview at localhost:3000. Changes will be automatically deployed to openra.github.io when a pull request is merged.