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



17 May 2013