on master help sign in
Update tutorial, changelog
commita5630e8adc54a4cac5fcb2e66c00fc27bdb536c2 authorJasper Van der Jeugt <jaspervdj@gmail.com> dateMon 21 Jun 2010, 17:10 (16 years ago) parente4840df
2 files changed+22−7
examples/hakyll/changelog.markdown+4 examples/hakyll/tutorials/part07.markdown+18−7
examples/hakyll/changelog.markdown+4
@@ -2,6 +2,10 @@
22title: Changelog
33---
44
5+## Hakyll 2.2
6+
7+- Allow markup languages in templates.
8+
59## Hakyll 2.1.1
610
711- Fix issues in autocompilation/preview mode.
examples/hakyll/tutorials/part07.markdown+18−7
@@ -1,6 +1,6 @@
11---
22title: Interlude
3−what: gives some various tips and tricks about Hakyll
3+what: gives some various tips and tricks about Hakyll (quite handy, read this!)
44---
55
66## Syntax-highlighting
@@ -69,12 +69,6 @@ A few examples:
6969The benefit of this is simply prettier URL's. That is, if you consider
7070`example.com/about` prettier than `example.com/about.html`.
7171
72−## The gist of it
73−
74−- Auto-compilation is handy, but a rebuild is recommended before deploying your
75− site.
76−- You can enable pretty URL's in Hakyll. It is, however, not the default.
77−
7872## Default values
7973
8074At some point, you might want to use a number of global key-value pairs, for
@@ -89,3 +83,20 @@ example, `$author`. There are two possible ways to achieve this.
8983 that autocompilation mode will pick up changes in this file[^1].
9084
9185[^1]: Original idea by zenzike.
86+
87+## Markup in templates
88+
89+Most of the examples in these tutorials use HTML for templates. However, since
90+Hakyll 2.2, it is possible use other markup languages in your templates. Simply
91+use an appropriate extension, and Hakyll will pick it up. For example, you could
92+write your `templates/post.markdown` template as:
93+
94+ # $title
95+
96+ _On $date_
97+
98+ $body
99+
100+__Warning__: you shouldn't use markdown for your "root" template, as these
101+templates will never insert things like the doctype for you -- so you always
102+need at least one top-level HTML template.