Working With Jekyll

14 Dec 2014

I’m still learning how to use Jekyll, a static-site generator, used with Github Pages. It’s basically a ruby gem, which is a library of ruby code, that compiles a directory of various file formats, primarily Markdown, into html pages.

Jekyll is a simple, blog-aware, static site generator. It takes a template directory containing raw text files in various formats, runs it through Markdown (or Textile) and Liquid converters, and spits out a complete, ready-to-publish static website suitable for serving with your favorite web server. Jekyll also happens to be the engine behind GitHub Pages, which means you can use Jekyll to host your project’s page, blog, or website from GitHub’s servers for free.


It has been a bit of a struggle for me to get the hang of Jekyll. I hope to learn more about how to use it to generate my User Github Page.

I just learned that I had to use Liquid template tags to get code highlighting.

Liquid is an extraction from the e-commerce system Shopify


def what?

CSharp (C#)

public class Greeting 
    private string _greeting = "Hello World.";

    public Greeting()


    public string Greeting { get { return _greeting; } }

Example Liquid snippet:

{% highlight php %}
    // your code here
    echo "Hello";
{% endhighlight %}

To display Liquid tags I had to use:

{ % raw % }
{ % endraw % }
// but without the space between { and % as shown above

I also learned that you can specify line numbers by using linenos or linenos=table:

{% highlight ruby linenos %}
def what?
{% endhighlight %}

However, due to problems with the mark-up generated, a better solution would be to create the line numbers using css instead.

Styling HTML Output

Basics In order to specify additional attributes to output in the html on the element, you start it with:

{: }

To specify a class it is


To specify a title attribute it is

{:title="My Title"}


  1. Github Pages
  2. What is a gem?
  4. Markdown
  5. Liquid
  6. Escape Liquid template tags in Jekyll posts
  7. Shopify
  8. CSS Line Nos
  9. Build A Blog With Jekyll And GitHub Pages