Document extension & configuration of Jinja2

[alanhogan]

Questions that should be answered by Hyde docs:

• In this configuration of Jinja2, is {{ var }} going to escape by default? (This would not be the Jinja2 package default, but makes sense)
• What is the custom {% mark %} and {% endmark %} syntax? Is it specific to markdown?
• Any other configuration and extensions

[navilan]

Agreed on all the points. Will make sure they are included.

Marking and reference will go here: http://hyde.github.com/templates/markrefer.html

To answer your question here, mark tag is there to block sections that need to be used elsewhere at a later point.

For example,

Here is a mark tag: https://github.com/hyde/hyde/blob/master/hyde/layouts/basic/content/blog/happy-post.html#L17-23 and here is how it is used: https://github.com/hyde/hyde/blob/master/hyde/layouts/basic/layout/macros.j2#L2-6