Repository for http://hotosm.github.com/learnosm/en/
Any updates in the gh-pages branch automatically update the site within minutes.
LearnOSM is built with Jekyll, learn more about Jekyll here:
Each chapter in a guide constitutes a markdown document. In order to handle languages and translations and to relate the document with a specific guide and a couple of [YAML Frontmatter] rules need to be in place. Note that the front matter described here is subject to slight changees with the ongoing site build.
Example front matter for a guide chapter:
layout: doc
title: Moving Forward
permalink: /en/beginner/moving-forward
lang: en
category: beginner
Explanation:
layout
must bedoc
title
is the plain title of the document, must not be repeated in the document's bodypermalink
is the path to the document, must contain the language prefix (en
in this case)lang
is the language prefix of the document and must be the same as inpermalink
. This is redundant withpermalink
for Jekyll specific reasons.category
contains the guide's shortname (beginner
in this case)