2012-02-17T11:00:37-08:00 http://massalabs.com/ Sean Massa endangeredmassa@gmail.com 2012-01-04T00:00:00-08:00 http://tom.preston-werner.com/2012/01/04/how-to-set-up-a-simple-blog-with-jekyll-and-github <h1><a href="/2012/01/04/how-to-set-up-a-simple-blog-with-jekyll-and-github.html">Setting up a blog with Jekyll, Github, and dnsimple</a></h1> <p><em>Sean Massa &#8211; 04 Jan 2012</em></p> <h2>Step #1: Github</h2> <p>This step involves setting up your github repository to properly respond to a domain name.</p> <ol> <li>Register for <a href="http://github.com">Github</a> if you don&#8217;t already have an account.</li> <li>Create a new repository called yourusername.github.com.</li> <li>Clone it locally by running `git clone git@github.com:yourusername/yourusername.github.com.git`</li> </ol> <p>Now we&#8217;re ready to put some content on our blog! If you go to yourusername.github.com, you should now see a page that says you need to setup some content for your blog. If you need more help for this part, take a look at the <a href="http://pages.github.com/">Github Pages</a> documentation.</p> <h2>Step #2: Jekyll</h2> <p>This step involves setting up Jekyll for your static content generation.</p> <ol> <li>This requires ruby. Make sure that&#8217;s installed.</li> <li>Install the Jekyll gem with `gem install jekyll`.</li> <li>Find a <a href="https://github.com/krisb/jekyll-template">template</a> that you like and clone it. Or, take a look at <a href="https://github.com/mojombo/jekyll/wiki/sites">an existing site</a> and copy the structure.</li> </ol> <p>You should now be able to see your content by executing `jekyll &#8212;server &#8212;auto` in your repository directory. The &#8212;auto flag will make the server recompile pages based on files you change. If you need more help with this, take a look at the <a href="https://github.com/mojombo/jekyll">Jekyll</a> documentation.</p> <h2>Step #3: dnsimple</h2> <p>This step involves setting up your domain name to point to your Github Pages blog.</p> <ol> <li>Go to <a href="https://dnsimple.com/signup">dnsimple</a> and register for an account.</li> <li>Find a domain name that is available and register it.</li> <li>View your registered domain and click &#8220;Add services to domain&#8221;.</li> <li>Add the Github Pages service.</li> <li>Once you are back at your domain management page, click the &#8220;Advanced Editor&#8221; button.</li> <li>Edit your <span class="caps">CNAME</span> entry to point to yourusername.github.com.</li> <li>Go to your git repository and create a file called <span class="caps">CNAME</span> with the content mydomain.com.</li> <li>Push your <span class="caps">CNAME</span> change to your git repository.</li> <li>Wait a few seconds.</li> <li>Go to mydomain.com and see if it worked!</li> </ol> <p>At this point, your domain should be pointing to your Github Pages content. If not, look at one of the documentation sites I linked above. If this guide was unclear, let me know <a href="mailto:endangeredmassa@gmail.com">via email</a> or a comment.</p>