How to setup your personal GitHub page
using Jekyll, Bootstrap, MathJax, and some other Liquid plugins

Disclaimer: this is not a complete guide, I’ve just taken notes for myself in case I will need to repeat the process again.

Facts, My Reasoning

• Students, researchers, etc. need a personal website to list their publications, provide additional information on those.
• I have one, but I will end up losing it (cf. personal experience) after I graduate.
• You can register a free GitHub account and it provides GitHub Pages for free, including the hosting and static content generation from your entries.

Setup, test local, push

1. Follow the steps in http://jekyllbootstrap.com/
2. After cloning the Jekyll+Bootstrap, read http://jekyllbootstrap.com/usage/jekyll-quick-start.html
3. Compile files with $ jekyll build, start the local server with $ jekyll -w serve.
4. Hack theme files, stylesheets, default pages, headers, etc. to your taste.
5. Check questions and answers at http://stackoverflow.com/questions/tagged/jekyll.
6. Find useful Liquid plugins, such as, for embedding YouTube videos or displaying equations using MathJax.
7. Additional information: GitHub Pages Help

Result

• This website onurkucuktunc.github.io
• or, if I get my own domain name, I can still use the GitHub Pages by setting up a custom domain with Pages.

---

---

Published

Tags

• jekyll 1
• bootstrap 1
• mathjax 1