Source for cabrillorobotics.org.
These instructions are for Ubuntu. For other OS view the installation guide.
-
Install Ruby and other prerequisites.
sudo apt-get install ruby-full build-essential zlib1g-dev
-
Avoid installing RubyGems packages (called gems) as the root user.
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc source ~/.bashrc
-
Install Jekyll and Bundler.
gem install jekyll bundler
- To deploy the site on a local server to see live changes as you develop, run the following in the root directory of this repository.
bundle exec jekyll s
- If
zsh: command not found: bundle
or similar error, re-source thebashrc
.source ~/.bashrc
- Follow the link provided following the
Server address:
qualifier. Should look something like the following.Server address: http://127.0.0.1:4000
- Save the content then refresh the page with
ctrl-shift-r
to see live changes (reload the current page, ignoring cached content).
- GitHub actions will build and deploy the pages upon push to this branch.