release-blog/README.md

⚠️ WARNING:

This Repository is in maintenance mode, issues are disabled and we don't take pull requests.

Test Release Blog Locally

The release blog runs on Jekyll. Jekyll is a Ruby framework, therefore the Ruby language should be installed on your OS.

Jekyll is often packaged by Linux distributions so the following instructions should work in most cases:

$ sudo apt install jekyll
$ git clone the repo
$ jekyll serve
$ Go to http://localhost:4000

However, if you do not want to install a Web framework and all of its dependencies at the OS level, you can install Jekyll, Bundler (Ruby dependency manager) and all of the dependencies (gems) in the project itself.

First edit your ~/.bashrc file and add the following lines:

# Find locally installed Ruby apps
if which ruby >/dev/null && which gem >/dev/null; then
    PATH="$(ruby -rubygems -e 'puts Gem.user_dir')/bin:$PATH"
fi

Then open a new terminal or reload your configuration in an existing terminal:

source ~/.bashrc

The installation process for the blog on Ubuntu/Debian is:

$ sudo apt install ruby-full
$ sudo apt install zlib1g-dev # Dependency requirement for the nokogiri gem
$ git clone https://github.com/mozilla/release-blog.git
$ cd release-blog
$ gem install bundler --user-install
$ bundle config set path 'vendor/bundle'
$ bundle install
$ bundle exec jekyll serve
$ Go to http://localhost:4000

You may need to set up a personal token from GitHub even when running locally.

Flags

• $ --no-watch (Do not watch for changes)
• $ --watch (Make changes on the fly)
• $ --trace (For debug)