Setup github.io page with Jekyll

Now that I am blogging about programming, I’ve figured that I should start a separate blog just for that, which I can showcase to others without the risk of political incorrectness (which of course requires I keep it strictly technical). I had thought of blogspot, but the pros use github.io. So I naturally looked into that. And I’ve decided that I’m going to document the process as I go.

First, I found that the version of ruby on my mac was not to date, so I used rbenv to install a sufficiently up to date version. However,

ruby -v

did not change though almost certainly, the later version was installed. Annoying, it meant that I had to point the ruby bash command to the newly installed executable either directly or indirectly. I had done this shit quite a while ago, and now it recycles, just like every time you start a new tech job, you have to go through a not terribly fun setup process. Fortunately, switching to rvm did the trick.

See, I had created on my github a repository for my github.io page, selected a theme (kind of like a WordPress theme), and git cloned that to my local machine. But when I, per instructions here, run

bundle exec jekyll serve

it complains

jekyll 3.8.3 | Error:  The jekyll-theme-cayman theme could not be found.

So I decide to start all over with

jekyll new . --force

Now when I ls the directory, I get

404.html	Gemfile		Gemfile.lock	_config.yml	_posts		about.md	index.md

Running again

bundle exec jekyll serve

gives me

Configuration file: cwdir/_config.yml
            Source: cwdir/me.github.io
       Destination: cwdir/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
                    done in 1.555 seconds.
 Auto-regeneration: enabled for me.github.io'
    Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.

Going there gives me

Screen Shot 2018-06-11 at 6.03.38 PM
And now I git commit and push to GitHub and see it at the actual hosted page!