Recology

R/etc.

Moving from blogger and wordpress to jekyll

    thoughts blogger wordpress jekyll
 Source: .Rmd/.md

Recology used to be hosted on Blogger, and my personal website was hosted on Wordpress. Neither platform was very satisfying. Blogger is very limited in their layouts, unless you use dynamic views, which suck because they don’t allow javascript snippets to render GitHub gists. Wordpress is just limited all around as you can’t put in hardly anythig excep text and some pictures. They both have their place, but not so much for content that requires syntax highlighting, references, etc.

Jekyll powered sites on GitHub are an awesome alternative. You do have to write the code yourself, but you can copy any number of templates on GitHub with a simple git clone onto your machine, edit the text a bit, push it up to GitHub, and that’s it.

On Blogger and Wordpress you can’t see the code behind why different blogs/sites look different. But on Jekyll/GitHub you can see the code behind each site (see here for a list of Jekyll/GitHub sites and their source code), which makes learning so easy.

Here is a video on YouTube that explains in some detail Jekyll/GitHub sites:

A great point in the video above is that a Jekyll site allows a workflow that is great not only for code-junkies, but for scientists. What is the most important thing about science? That it is reproducible of course. Documenting your code and sharing with everyone on GitHub or SVN, etc. is great for science in facilitating collaboration and facilitating transparency. Having your website/blog on Jekyll fits right in to this workflow (that is, pull down any changes - write/edit something - commit - push to GitHub). Although this sort of worklow isn’t necessary for a blog, it is nice for scientists to use this workflow all the time.

Here’s how to get started:

  1. Install git
  2. Get a free GitHub account and configure GitHub. If you are afraid of the command line, there is a great GitHub app here.
  3. git clone a jekyll template to your machine. There are hundreds of these now. Look here for your favorite, and git clone it. ***
  4. Edit the template you have cloned, and commit and push to GitHub. That’s it. It will take just a bit to render.

There is more to it than that, but that is how you can get started. If you want to add comments, Disqus is a great option. Once you fork someones jekyll site, make sure to change all the personal/site specific information to your information, including the RSS feed.

*** Note: You can name your repo for your site/blog as yourgithubname.github.com if you want your URL for the site to be http://yourgithubname.github.com. Or you can name your repo whatever you want, e.g., disrepo, then the URL will be http://yourgithubname.github.com/disrepo.

comments powered by Disqus