Mercurial > piecrust2

annotate docs/docs/06_themes.md @ 811:c7393ce2dde7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
admin: Add quick links in sidebar to create new posts/pages.
author Ludovic Chabant <ludovic@chabant.com>
date Mon, 19 Dec 2016 22:31:30 -0800
parents 171051e1aca5
children 31f2964d034a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
749
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
1 ---
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
2 title: Themes
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
3 ---
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
4
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
5 Themes let you change your website's appearance easily by applying a new set of
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
6 templates, layouts, and styles over you content. You're probably already
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
7 familiar with this concept if you're coming from some other CMS like WordPress.
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
8
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
9 In PieCrust, themes work better if you don't have any templates -- otherwise,
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
10 you would end up mixing the theme's appearance with your own, which (unless it
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
11 was done specifically against a given theme) probably won't work well.
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
12
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
13 Themes are really just normal PieCrust websites, but with a `theme_config.yml`
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
14 file instead of `config.yml`. You can easily install them, change them, or
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
15 create your own.
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
16
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
17
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
18 {% for part in family.children -%}
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
19 * [{{part.title}}]({{part.url}})
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
20 {% endfor %}
171051e1aca5 docs: Very basic theme documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
21