GeoMesa.org
Very much in progress...
This site is built with jekyll , a static site generator.
Installing jekyll, etc.
- Make sure Ruby and rubygems are installed (preferrably ruby1.9.3)
- Install jekyll:
sudo gem install jekyll
(requires ruby > 1.9.2 on ubuntu) - Install kramdown :
sudo gem install kramdown
- Install Pygments :
sudo apt-get install pygments
(or python-pygments) - Install nodejs which needed by newer versions of jekyll for a javascript/coffeescript runtime
The command jekyll serve --watch
will generate the site in the _site
directory, watch source files for changes, and serve it locally on port 4000.
Adding a tutorial
- Add a markdown file with the following naming convention to the
_posts
directory: YYYY-MM-DD-[title-of-the-tutorial].md. - In
_config.yml
make sure the author of the tutorial exists in theauthors
list. - Add the following to the top of the tutorial markdown file:
---
title: (the title of the tutorial)
author: (the author key in the list in `_config.yml`)
layout: tutorial
---
{% include tutorial-header.html %}
(...your content here.)
The content between the ---
's is FrontMatter . The content between the {% %}
is Liquid .
Syntax highlighting
Wrap any code snippets in the totorial in the following Liquid statements:
{% highlight LANGUAGE_IDENTIFIER %}
... code ...
{% endhighlight %}
Language identifiers can be found on the Pygments website.
You can add line numbers to the code snippet by including linenos
after the language identifier, i.e. {% highlight scala linenos %}
Notes
- Changes made to
_config.yml
will not be caught inwatch
mode--need to restart jekyll.