Build rapid and lightweight static websites with Hyde - IBM

ibm.com/developerWorks/ developerWorks®
Listing 5 illustrates the use of Markdown to express part of a page's content,
using the {% filter markdown -%} instruction to invoke Hyde's built-in markdown
converter.
Listing 5. Example page based on Listing 3, but overriding two Jinja template
blocks, using Markdown
--- extends: minimalism.j2 title: Strange Case of Dr Jekyll and Mr Hyde
description: Tribute to a Victorian classic ---
{% block intro %}
{% filter markdown -%}
# *Strange Case of Dr Jekyll and Mr Hyde*
## "I knew myself, at the first breath of this new life, to be more wicked..."
{%- endfilter %}
{% endblock intro %}
{% block group1 %}
{% filter markdown -%}
### The author
**Robert Louis Balfour Stevenson** (13 November 1850 – 3 December 1894) was a
Scottish novelist, poet, essayist and travel writer. His best-known books include
*Treasure Island*, *Kidnapped*, and *Strange Case of Dr Jekyll and Mr Hyde*
{%- endfilter %}
Read more
{% endblock group1 %}
Only the content within the filter instructions are interpreted as markdown. Notice how
those bits are flush left, unlike the HTML bits, which are indented according to block
elements. This is because indentation is significant in Markdown and not in HTML.
Summary
I only scratched the surface of the features available in Jinja templates and other
components of Hyde. That works fine because Hyde is designed so that you can
begin with the simpler functions and work up to more sophisticated features as
you go along, whenever you need to enhance automation and workflow. You can
develop many simple web pages with simple blocks (which you can nest). If you need
automatically compiled weblogs and the like, Hyde's default layout provides a good
example.
Overall, Hyde gives you most of the features of content management systems and
low-level web publishing frameworks. With the file system as the backing store, very
little of your system is obscured or mysterious. I think this is a great benefit, and you
now have enough of the basics to get started and create a simple web page with
Hyde, and a web design template of your choosing.
Build rapid and lightweight static websites with Hyde Page 7 of 9