summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorChristian Weiske <cweiske@cweiske.de>2011-05-25 19:43:36 +0200
committerChristian Weiske <cweiske@cweiske.de>2011-05-25 19:43:36 +0200
commit5ba53394fcda4ae9cfa9af52b37fb67517deeb5a (patch)
tree4416be7903a2b339382e9f933284f50797edc239 /doc
parent63b0a4b8cb38a8a7c41410900b9dfcc84e6a33a9 (diff)
downloadsemanticscuttle-5ba53394fcda4ae9cfa9af52b37fb67517deeb5a.tar.gz
semanticscuttle-5ba53394fcda4ae9cfa9af52b37fb67517deeb5a.tar.bz2
implement request #1989987: theme support. merge themes branch with --squash
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog3
-rw-r--r--doc/themes.rst48
2 files changed, 51 insertions, 0 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 8fa208c..ade19af 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,6 +1,9 @@
ChangeLog for SemantiScuttle
============================
+- Implement request #1989987: Theming support
+
+
0.98.0 - 2011-XX-XX
-------------------
- Switch to jQuery and drop dojo
diff --git a/doc/themes.rst b/doc/themes.rst
new file mode 100644
index 0000000..6f34a36
--- /dev/null
+++ b/doc/themes.rst
@@ -0,0 +1,48 @@
+======================
+SemanticScuttle Themes
+======================
+SemanticScuttle may be changed visually by supplying custom "themes" (skins)
+that modify the visual appearance.
+
+
+Changing the current theme
+==========================
+In ``data/config.php``, set your theme like this: ::
+
+ $theme = 'darkmood';
+
+The available themes are the folders in ``www/themes/``.
+By default, SemanticScuttle ships only one usable theme ("default") and one
+to demonstrate how to create your own theme ("testdummy").
+
+
+Creating your own theme
+=======================
+Have a look at the "testdummy" theme in ``www/themes/testdummy/``.
+
+CSS and image files
+-------------------
+Since both file types need to be accessible via the web server directly,
+they are located in the ``www/`` folder: ::
+
+ www/themes/$themename/
+
+The main CSS file that automatically gets included is ::
+
+ www/themes/$themename/scuttle.css
+
+Several template files in SemanticScuttle include image files. If they do not
+exist in your theme, the default ones are used automatically.
+Note that this is not true for images that are specified in the CSS files.
+
+
+Template files
+--------------
+The templates of the default file are located in ::
+
+ data/templates/default/
+
+You may put your theme template files into ::
+
+ data/templates/$themename/
+