This guide walks you through creating your own website (much like this one) using ruby, the Jekyll framework and the al-folio theme. Enjoy!

  • OS: Ubuntu 22.04.1 LTS

Update the apt package manager

sudo apt update && upgrade -y

Install a Ruby version manager for this project

sudo apt install rbenv
rbenv init

reload or restart the shell

source ~/.bashrc on ubuntu or source ~/.zshrc on Mac OS

install ruby-build for a simplified ruby installation as an rbenv plugin

git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
git -C "$(rbenv root)"/plugins/ruby-build pull

install your prefered Ruby version (I used 3.1.2):

rbenv install X.X.X

Set a Ruby version to finish and start using Ruby

rbenv global 3.1.2   # set the default Ruby version for this machine
# or:
rbenv local 3.1.2    # set the Ruby version for this directory

Install the bundler gem

gem install bundler

Fork the Jekyll theme from github.com:alshedivat/al-folio to github.com:/

build your theme

cd <your-repo-name>
bundle install
bundle exec jekyll serve

Customize the theme (e.g. using VS Code)

code .

  • Tip: You can navigate to http://127.0.0.1:4000/al-folio/ to see your portfolio. Refresh to see changes.

Sources

  1. rbenv README
  2. ruby-build README
  3. al-folio README