How to install and build your own static website using Jekyll
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.