Site Credits

Photo by Ian Livesey from StockSnap

The Basics

• Github, Jekyll, Poole

Resources

• Start with the Poole for setting up a basic site. When in doubt, you may refere to the Jekyll and Github Pages documentation:

  • The official Jekyll website.

  • Github Pages documentation with Jekyll.

• @joshualande blog article on using Jekyll, Github Pages, and Poole provided all the required details about setting up blog “pages”, the blog posts archive page, adding disqus comments etc. Highly recommend this article.

Todo:

• Fulltext Search on Jekyll site http://dreamand.me/web/fulltext-search-at-jekyll-site/

• Add tags and categories for posts; list posts under archives by tags/categories. Is this what I should look at? https://github.com/jekyll/jekyll-archives

• Image gallery. Try a without plugin approach of adding an image gallery. While there, try other features.

Inspiration

The inspiration to do a blog on github pages came to me while I was exploring markdown. As of Dec 2015, I get inspired by a very informative blog by Ben Balter that uses Jekyll + Github Pages.

Tips

There are some gotchas that one has to be aware of when setting up the site. I had trouble with baseurl config setting when not using custom domain. Came across a Jekyll issue comment on how to serve on localhost. The following should allow the render on localhost without affecting the relative URLs of the posts:

$ jekyll serve --baseurl ''

If you want to serve ‘drafts’ on localhost, then you may try the following:

`$ jekyll serve –drafts server –baseurl ‘

Resources

Photographs: For royalty free photographs, you may use Pexels, Unsplash, StockSnap and others.