Getting started

For more about how to use Jekyll, check out this tutorial. Why Jekyll? Read Andrej Karpathy’s blog post!


Local setup

Assuming you have Ruby and Bundler installed on your system (hint: for ease of managing ruby gems, consider using rbenv), first fork the theme from to<your-username>/<your-repo-name> and do the following:

$ git clone<your-username>/<your-repo-name>.git
$ cd <your-repo-name>
$ bundle install
$ bundle exec jekyll serve

Now, feel free to customize the theme however you like (don’t forget to change the name!). After you are done, commit your final changes.


Deploying your website to GitHub Pages is the most popular option. Starting version v0.3.5, al-folio will automatically re-deploy your webpage each time you push new changes to your repository! :sparkles:

For project pages (default):

For personal and organization webpages:

NOTE: you must do all your changes in the source branch (the one you used to push) NOT the master one; this last one is used for deploying by Github Pages and it is not suitable for pushing changes.