A First Post

Brian Keng

2015-08-02 05:03

Hi all, this the first post in my technical blog. For a long time I've resisted making a blog about anything technical because, to be frank, I didn't feel like I was qualified. What makes me more qualified now? Nothing really, I'm just a bit less afraid of being wrong.

So maybe a good place to start is what I used to setup this blog and what the domain/title mean. For my personal blog (www.briankeng.com), where I discuss random worldly wisdom that I come across, I use WordPress. For this one, I used something a bit more technical (because why not?):

Github Pages

Great place to host a static website (free) but also has some of that "hacker cred". It's quite easy to use (if you've used git before) and also quite well documented on how to get your domain setup.

Nikola (static site generator)

The recommended static site generator with Github Pages is Jekyll but one thing I wanted for this site is to make use of IPython Notebooks. After a bit of searching, I found Nikola to be a good match because it supports IPython Notebooks out of the box (as opposed to Jekyll which required some fiddling), and seemd to have a reasonably simple setup. The really interesting line from the documentation is this quote: DON'T READ THIS MANUAL. IF YOU NEED TO READ IT I FAILED, JUST USE THE THING. Exactly the sentiment I was going for.

Bootstrap3 theme and Readable Bootstrap theme.

Bootstrap3 is the default theme for Nikola, conveniently using Bootstrap, the most popular HTML/CSS/JS framework for the web. Since I'm not a very good designer using high quality themes/framework is definitely ideal.

The default Nikola theme, however, was not too my liking. A bit too spartan for me. Fortunately, Nikola has a really cool feature where you can take an existing Bootstrap theme from http://bootswatch.com and skin the default Nikola Bootstrap theme. I chose the Readable theme because I'm a huge fan of making things easy-to-read (you should see how large the font size is on my devices, frequently referred to as "old people font size").

Even with the new Bootstrap theme, the site layout didn't quite look right. So I fiddled around with the layout and placement of items, pretty much copying the layout of another blog I really enjoy programming in the twenty-first century by James Hague. It was interesting playing around with HTML templates and CSS but pretty much confirmed that it's not really what I like doing. Getting to a satisfactory layout was as much effort as I really wanted to put in.