# HG changeset patch
# User Ludovic Chabant <ludovic@chabant.com>
# Date 1465536702 25200
# Node ID 171051e1aca58e2b1a25fd3867b24063dc26af85
# Parent  6db54bed24179d941c4da30beda3ec9a04490206
docs: Very basic theme documentation.

diff -r 6db54bed2417 -r 171051e1aca5 docs/docs/06_themes.md
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/docs/06_themes.md	Thu Jun 09 22:31:42 2016 -0700
@@ -0,0 +1,21 @@
+---
+title: Themes
+---
+
+Themes let you change your website's appearance easily by applying a new set of
+templates, layouts, and styles over you content. You're probably already
+familiar with this concept if you're coming from some other CMS like WordPress.
+
+In PieCrust, themes work better if you don't have any templates -- otherwise,
+you would end up mixing the theme's appearance with your own, which (unless it
+was done specifically against a given theme) probably won't work well.
+
+Themes are really just normal PieCrust websites, but with a `theme_config.yml`
+file instead of `config.yml`. You can easily install them, change them, or
+create your own.
+
+
+{% for part in family.children -%}
+* [{{part.title}}]({{part.url}})
+{% endfor %}
+
diff -r 6db54bed2417 -r 171051e1aca5 docs/docs/06_themes/01_installing-a-theme.md
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/docs/06_themes/01_installing-a-theme.md	Thu Jun 09 22:31:42 2016 -0700
@@ -0,0 +1,14 @@
+---
+title: Installing a Theme
+---
+
+There are 2 ways to install a theme in PieCrust:
+
+1. If you have a library of themes somewhere, you can set its root directory as
+   your `site/themes_dirs` site config setting, and set `site/theme` as the name
+   of the theme you want.
+
+2. If you just have the one theme, you can make a link to it in your website
+   with the `chef themes link` command.
+
+
diff -r 6db54bed2417 -r 171051e1aca5 docs/docs/06_themes/02_creating-a-theme.md
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/docs/06_themes/02_creating-a-theme.md	Thu Jun 09 22:31:42 2016 -0700
@@ -0,0 +1,9 @@
+---
+title: Creating a Theme
+---
+
+A theme is really just a normal PieCrust website, but with a `theme_config.yml`
+config file instead of a `config.yml`.
+
+You can create a new theme by running `chef --theme init foo`.
+