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