Installing Ruby and Jekyll was not such a big issue. But it took me quite sometime to start experimenting with the feel of writing a managing a blog from here.

These are notes to future self to track what’s going on and how it feels.

Customizing Jekyll

Starting a Jekyll blogs gives you a home, an about section and some posts. Most of the defaults are edited through the _config.yml settings. Adding a post is a matter of markdown and github docs contents have all the info to get started and add some content (like these post).

Good news

I’ve read that _config.yml files are not reloaded automatically (rerunning the build is required). But it seems that pushing new stuff on git triggers the build. So that’s it.

Editing the about

This page helped me fixing the about. It’s mainly about the markdown and _config.yml files having the control rather then the .html files.

I like this, but still I have to take full advantage of this.

False Starts

  • editing the index.html files for the about using the thegui.eu and other references to variables set in config.

Deleting content/editing content

Markdown comes first. Edit the markdown to edit. Cancel the markdown to see the posts go away.

Display the categories

This gist was enough to get all the categories to show up. All I have to add was an html tag in the markdown, otherwise the code specs run (i.e.: all categories are selected, etc, all the are resolved and process, but the html tags will be written rather than compiled).

Still, this was not enough to add to the home.

Adding layouts and editing home

To have the categories showing up in the main page as its content I realized I need to change Jekyll layout. Adding what I need in the about.markdown did not work. You get the text, but it comes before everything else.

So here is the folder structure of Jekyll themes and layout and here is the home sourcecode.

Back to Categories

As I managed to include the categories in the home I realized there was something wrong with the mechanism. Categories in the gist are provided as a set of two lists. The first has the categories added and the count. Clicking on them sends you to the list of the category with links to the pieces tagged with that category. Now you click on them and can reach the pieces.

Issue with the URLs

Probably due to the way post.url and site.url works on the github powered engine I had to remove the site.url tag to create the correct link to the post. So I have this:

  • Google Analytics (Includes)

    The minima theme includes also a dedicated file to add Google Analytics.

    Taking a look at the code we see this:


    So we need to set a google_analytics var in the config.yml file.

    Add a new section with permalink

    I want to add a further section next to the about one. I want it to point to my Digital Humanities book.

    Stackoverflow helped with buttons but the issue was that I needed to find the right place to put the button.

    Again, I had to check the _includes and add the header.html file and customize it. Right before the loop that watches for your file and build sections out of it, you can add what you need. Cool.

    Build error

    If you use the include tag somewhere in your layouts or site and don’t have the corresponding html file in the _includes folder you get an error and the build fails.

    To Do

    • display categories
    • analytics
    • adding more sections
    • try to delete a post
    • handle redirects etc (will it require to check posts and categories again?)

    Catogeries experiment

    Will this work?


    Test compiles but it’s not rendered