Quick Start

1. Set up ruby environment. First install ruby using brew:

   $ brew install ruby
   

   Add following line in ~/.gemrc

   gem: --user-install
   

   Install bundler

   $ gem install bundler
   

   Check your ruby environment

   $ gem env
   

   It will show you gem path. Ensure that ge path shown there are in your PATH.

   If not, update your PATH in .bashrc

   export PATH="/usr/local/lib/ruby/gems/2.7.0/bin:${PATH}"
   

2. Change directory to where you have cloned the repo.

   $ cd <github-pages-repo ...>
   $ bundle install
   

   This will install Jekyll and any other Ruby gems/plugins needed.

3. Build the site, it generates output in _site directory

   $ jekyll build
   $ ls -l <...>/_site
   $ cat <...>/_site/index.html
   

   To build production version:

   $ JEKYLL_ENV=production jekyll build
   

4. Start Jekyll Server

   $ jekyll serve
   

5. See website at localhost:4000

Markdown

Most of the content is in Markdown language, and here is an helpful Cheetsheet. There are several online markdown editors, for example JBT, StackEdit, and Dillinger.

Syntax highlighting stylesheet was generated as following:

$ rougify style github > assets/common/css/syntax-github.css

Blog posts Directories

• blog/_posts/ : English blog posts
• blog/_posts/trekking : Trekking blog posts
• tech/_posts/ : Posts on programming, technology etc.
• hindi/_posts/blog : हिन्दी ब्लॉग
• hindi/_posts/manpraan : मन-प्राण
• hindi/_posts/madhyaahan : मध्याहन
• hindi/_posts/besabab : बेसबब
• hindi/_posts/brihannala : बृहन्नला
• hindi/_posts/other : अन्य