Mercurial > piecrust2

annotate docs/docs/99_reference/07_template-engines.md @ 1057:fd95fef51705

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
docs: Update documentation on sources and pipelines.
author Ludovic Chabant <ludovic@chabant.com>
date Thu, 01 Feb 2018 22:03:33 -0800
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1057
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
1 ---
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
2 title: "Appendix 7: Template Engines Reference"
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
3 short_title: Template Engines Reference
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
4 ---
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
5
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
6 When a page gets rendered, it goes through a template engine that can expand
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
7 special syntax that runs logic. This is useful for authoring pages that list
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
8 blog posts by date or category, for instance.
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
9
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
10 Here is a list of the template engines that come with PieCrust out of the box.
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
11
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
12
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
13 ## Jinja2
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
14
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
15 Name: `jinja2`
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
16
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
17 [Jinja2][j2] is a powerful template engine that is set by default in PieCrust.
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
18 You can read the [templating documentation here][j2tpl].
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
19
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
20
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
21 ## Mustache
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
22
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
23 Name: `mustache`
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
24
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
25 [Mustache][mt] is a minimal template engine that runs fast and keeps your
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
26 templates files simple and clean.
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
27
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
28
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
29 [j2]: http://jinja.pocoo.org/
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
30 [j2tpl]: http://jinja.pocoo.org/docs/latest/templates/
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
31 [mt]: https://mustache.github.io/
fd95fef51705 docs: Update documentation on sources and pipelines.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
32