Mercurial > piecrust2

annotate docs/docs/06_themes.md @ 1032:54159951d97a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
bake: Add `--sources` argument.
author Ludovic Chabant <ludovic@chabant.com>
date Tue, 16 Jan 2018 08:38:06 -0800
parents 31f2964d034a
children
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
819
31f2964d034a docs: Correct typos
Raoul Bourquin <raoul@ccczh.ch>
parents: 749
diff changeset
6 templates, layouts, and styles over your content. You're probably already
749
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