Overview on writing nice templates for hyde
Hyde is designed to support more than one template language for creating layouts. However, hyde currently only supports jinja2. This section of the documentation will focus on creating templates using jinja2.
If you are not familiar with jinja2 its a good idea to go through the most excellent jinja2 documentation.
Hyde encourages separation of content from layout. The following shows a typical structure of a hyde website.
A good objective is to have all the files in content contain as little layout
as possible and be written with a text oriented markup language like
markdown. While its not always possible to achieve 100% separation, hyde
provides several nice tools to get very close to that goal.
Hyde by default makes the following variables available for templates:
site- Represents the container object of the entire site
node- The node (folder) where the current file resides
resource- The resource (file) that is currently being processed
- Context Variables - All variables defined under the
contextsection of the site configuration are available to the templates.
Read more information about
resource variables in
site model documentation.
Read more information about context variables in the configuration documentation.