Chris Waugh2011-11-10T16:21:50-08:00http://chriswaugh.github.com/Chris Waughhttp://chriswaugh.github.com/posts/2011/10/23/blogging-is-hardBlogging is hard2011-10-23T00:00:00-07:00<p>In the ten years I’ve been in the web game, I’ve always struggled to keep a blog. Not going to lie, it’s because I’m extremely lazy.</p>
<p>But it’s also because the main thing I like to write about is code. And displaying HTML code on a HTML page is a huge pain in the arse. Especially when you want it to be syntax highlighted.</p>
<h2>Finding a blog system</h2>
<p>I wanted something basically like Tumblr but that I had full control over. In the end it all boiled down to four points:</p>
<ol>
<li>I don’t want to have to spend hours setting up, configuring, or theming it.</li>
<li>I don’t want to have to buy extra hosting.</li>
<li>It must be easy to update.</li>
<li>It must allow Syntax Highlighting.</li>
</ol>
<p>And – ideally – it would be a lot of fun to hack on.</p>
<h2>Jekyll</h2>
<p><a href="http://jekyllrb.com">Jekyll</a> is a static site generator which runs from the command line and can be installed through Rubygems.</p>
<p>What makes it interesting is that you can write all your posts in your IDE right alongside your code (using <a href="http://daringfireball.net/projects/markdown/">markdown notation</a>), and the syntax highlighting is super awesome. Also, because it’s a static site generator, you can just take its output and have it hosted by anything that is accessible via the web. Even Dropbox, if you are some sort of crazed sadomasochist.</p>
<p>Getting started is as simple as:</p>
<div class="highlight"><pre><code class="bash">gem install jekyll
</code></pre>
</div>
<p>You can then just steal someone else’s blog, delete the posts and start hacking away!</p>
<div class="highlight"><pre><code class="bash">git clone git://github.com/chriswaugh/chriswaugh.github.com.git
<span class="nb">cd </span>chriswaugh.github.com
rm -rf .git
jekyll --server
</code></pre>
</div>
<h2>Horray for Github</h2>
<p>So it turns out that Jekyll comes from the brains behind Github and not only did they write it, they also host it via <a href="http://pages.github.com/">Github Pages</a>. For free! All you need to do is create a repo (e.g. <a href="http://github.com/chriswaugh/chriswaugh.github.com">chriswaugh.github.com</a>) and push all your content to it as normal. Then whenever you want to update your posts, just do another git push. Simple as that.</p>
<p>(I’m not getting paid for this post, seriously.)</p>
<p><em>Go to Github and spend money.</em></p>
<h2>Advertisement over</h2>
<p>If you’re a developer looking for a quick and easy way to share your thoughts and code snippets you’d be missing a trick if you didn’t try Jekyll. Seriously, it’s insanely easy, <a href="https://raw.github.com/chriswaugh/chriswaugh.github.com/master/_posts/2011-10-23-blogging-is-hard.markdown">check out the code for this post yourself</a>.</p>
<p><em>What are you waiting for?</em></p>
<div class="highlight"><pre><code class="html"><span class="nt"><h1</span> <span class="na">class=</span><span class="s">"q"</span><span class="nt">></span>Did I mention the Syntax Highlighting was really easy?<span class="nt"></h1></span>
<span class="nt"><p</span> <span class="na">class=</span><span class="s">"a"</span><span class="nt">></span>Yes, yes I did!<span class="nt"></p></span>
</code></pre>
</div>