3c7449397a
This mimics the GitHub Pages environment so that you can build and serve the site locally for testing. It's will also be required later for using Jekyll Actions[1] instead of the automated GitHub Pages flow. 1. https://github.com/marketplace/actions/jekyll-actions |
||
---|---|---|
.. | ||
_sass/color_schemes | ||
_config.yml | ||
adapting-existing.md | ||
atomic-upgrades.md | ||
buildsystem-and-repos.md | ||
contributing-tutorial.md | ||
CONTRIBUTING.md | ||
deployment.md | ||
formats.md | ||
Gemfile | ||
index.md | ||
introduction.md | ||
README-historical.md | ||
README.md | ||
related-projects.md | ||
repo.md | ||
repository-management.md |
This documentation is written in Jekyll format to be published on GitHub Pages. The rendered HTML will be automatically built and published, but you can also use Jekyll locally to test changes.
First you need to install Ruby and
RubyGems to get Jekyll and the other gem
dependencies. This is easiest using the distro's packages. On RedHat
systems this is rubygems
and on Debian systems this is
ruby-rubygems
.
Next Bundler is needed to install the gems using
the provided Gemfile. You can do this by running gem install bundler
or using distro packages. On RedHat systems this is
rubygem-bundler
and on Debian systems this is ruby-bundler
.
Now you can prepare the Jekyll environment. Change to this directory and run:
bundle config set --local path vendor/bundle
bundle install
Finally, render and serve the site locally with Jekyll:
bundle exec jekyll serve