Moving from blogger and wordpress to jekyll

January 11, 2012
By

(This article was first published on Recology, and kindly contributed to R-bloggers)

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.

*** 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.

To leave a comment for the author, please follow the link and comment on his blog: Recology.

R-bloggers.com offers daily e-mail updates about R news and tutorials on topics such as: visualization (ggplot2, Boxplots, maps, animation), programming (RStudio, Sweave, LaTeX, SQL, Eclipse, git, hadoop, Web Scraping) statistics (regression, PCA, time series, trading) and more...



If you got this far, why not subscribe for updates from the site? Choose your flavor: e-mail, twitter, RSS, or facebook...

Comments are closed.