al-folio

A simple, clean, and responsive Jekyll theme for academics. If you like the theme, give it a star!

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 github.com:alshedivat/al-folio to github.com:<your-username>/<your-repo-name> and do the following:

$ git clone git@github.com:<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. Now, you can deploy your website to GitHub Pages by running the deploy script:

$ ./bin/deploy [--user]

By default, the script uses the master branch for the source code and deploys the webpage to gh-pages. The optional flag --user tells it to deploy to master and use source for the source code instead. Using master for deployment is a convention for user and organization pages.

Note: when deploying your user or organization page, make sure the _config.yml has url and baseurl fields as follows.

url:  # should be empty
baseurl:  # should be empty

Here are some frequently asked questions. If you have a different question, please ask on gitter.

1. Q: When I preview my website locally everything looks great, but when I deploy it on GitHub bibliography Liquid tags are not recognized. How do I fix this?
   A: GitHub Pages rendering does not support certain Jekyll plugins, and jekyll-scholar that we use to render bibliography is one of them. Please make sure you deploy your website to GitHub using bin/deploy script that circumvents the issue.

2. Q: When I deploy my fork of al-folio, it says Deployed successfully! But when I open <my-github-username>.github.io, I get Page not found (404) error. How do I fix this?
   A: For personal webpages, please run bin/deploy --user. (See also relevant past issues: #5, #49, #86.)

The theme is available as open source under the terms of the MIT License.

Originally, al-folio was based on the *folio theme (published by Lia Bogoev and under the MIT license). Since then, it got a full re-write of the styles and many additional cool features.