Installation
sudo apt-get install ruby-full build-essential zlib1g-dev
gems are packages for the ruby language. don't do a system install for gems to avoid conflicts in the future.
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/.gems"' >> ~/.bashrc
echo 'export PATH="$HOME/.gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
bundler
installs gems based on config files.
jekyll
separates website formatting and content.
gem install jekyll bundler
Make the website
clone the github.io repository and cd
to the root folder. Create the base files jekyll uses
jekyll new --skip-bundle
modify the versions of jekyll and gihub-pages packages used
vim Gemfile
gem "jekyll", "~> 3.9.2"
gem "github-pages", "~> 227", group: :jekyll_plugins
modify the _config file
#theme: minima
remote_theme: pages-themes/minimal@v0.2.0
plugins:
- jekyll-remote-theme
bundle install
see https://pages-themes.github.io/minimal/ for examples on how to add content
Host the website locally with Jekyll
bundle exec jekyll serve
go to:
http://localhost:4000
with a web browser
Host the website on-line
set the branch in repository settings on github.com push the repo to a branch that github is serving to https://arrenglover.github.io