| CARVIEW |
mojombo / jekyll
Pledgie Donations
Once activated, we'll place the following badge in your repository's detail box:
Jekyll is a blog-aware, static site generator in Ruby
Liquid Extensions
Jekyll uses Liquid to process templates. Along with the standard liquid tags and filters, Jekyll adds a few of its own:
Filters
Date to XML Schema
Convert a Time into XML Schema format.
{{ site.time | date_to_xmlschema }} => 2008-11-17T13:07:54-08:00
XML Escape
Escape some text for use in XML.
{{ post.content | xml_escape }}
Number of Words
Count the number of words in some text.
{{ post.content | number_of_words }} => 1337
Array to Sentence
Convert an array into a sentence.
{{ page.tags | array_to_sentence_string }} => foo, bar, and baz
Textilize
Convert a Textile-formatted string into HTML, formatted via RedCloth
{{ page.excerpt | textilize }}
Tags
Include
If you have small page fragments that you wish to include in multiple places
on your site, you can use the include tag.
{% include sig.textile %}
Jekyll expects all include files to be placed in an _includes directory at the root of your source dir. So this will embed the contents of /path/to/proto/site/_includes/sig.textile into the calling file.
Code Highlighting
Jekyll has built in support for syntax highlighting of over 100 languages via Pygments. In order to take advantage of this you’ll need to have Pygments installed, and the pygmentize binary must be in your path. When you run Jekyll, make sure you run it with Pygments support
To denote a code block that should be highlighted:
{% highlight ruby %}
def foo
puts 'foo'
end
{% endhighlight %}
The argument to highlight is the language identifier. To find the appropriate identifier to use for your favorite language, look for the “short name” on the Lexers page.
There is a second argument to highlight called linenos that is optional. Including the linenos argument will force the highlighted code to include line numbers. For instance, the following code block would include line numbers next to each line:
{% highlight ruby linenos %}
def foo
puts 'foo'
end
{% endhighlight %}
In order for the highlighting to show up, you’ll need to include a highlighting stylesheet. For an example stylesheet you can look at syntax.css. These are the same styles as used by GitHub and you are free to use them for your own site. If you use linenos, you might want to include an additional CSS class definition for lineno in syntax.css to distinguish the line numbers from the highlighted code.
