From 70457742d1daac1e58b018d480e0d7597bc2decd Mon Sep 17 00:00:00 2001
From: Pierre-Yves Chibon <pingou@pingoured.fr>
Date: Feb 20 2016 10:26:10 +0000
Subject: Start documenting a little how theming pagure works


---

diff --git a/doc/theming.rst b/doc/theming.rst
new file mode 100644
index 0000000..988f93f
--- /dev/null
+++ b/doc/theming.rst
@@ -0,0 +1,15 @@
+Theme your pagure
+=================
+
+Pagure via `flask-multistatic <https://pagure.io/flask-multistatic>`_
+offers the possibility to override the default theme allowing to customize
+the style of your instance.
+
+By default pagure looks for its templates and static files in the folders
+``pagure/templates`` and ``pagure/static``, but you can ask pagure to look
+for templates and static files in another folder.
+
+By specifying the configuration keys ``THEME_TEMPLATE_FOLDER`` and
+``THEME_STATIC_FOLDER`` in pagure's configuration file, you tell pagure to
+look for templates and static files first in these folders, then in its
+usual folders.