summaryrefslogtreecommitdiff
path: root/theme/README
diff options
context:
space:
mode:
authorEvan Prodromou <evan@status.net>2009-12-02 11:07:57 -0500
committerEvan Prodromou <evan@status.net>2009-12-02 11:07:57 -0500
commit4205d25d226ed7bfd42ff13035ea208aa3cb1ce6 (patch)
tree1d2cc44421a2aff3414d3951033cfd159782b10c /theme/README
parentba4fd15abd2978439118ed167cbaa4973548b68c (diff)
parent14eeef4ac49e5f8c49446c1ac20654d6300ce00b (diff)
Merge branch '0.9.x' of git@gitorious.org:statusnet/mainline into 0.9.x
Diffstat (limited to 'theme/README')
-rw-r--r--theme/README38
1 files changed, 38 insertions, 0 deletions
diff --git a/theme/README b/theme/README
new file mode 100644
index 000000000..266a89fdf
--- /dev/null
+++ b/theme/README
@@ -0,0 +1,38 @@
+/** Howto: create a StatusNet theme
+ *
+ * @package StatusNet
+ * @author Sarven Capadisli <csarven@status.net>
+ * @copyright 2009 StatusNet, Inc.
+ * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
+ * @link http://status.net/
+ */
+
+Location of key paths and files under theme/:
+
+./base/css/
+./base/css/display.css
+./base/images/
+
+./default/css/
+./default/css/display.css
+./default/images/
+
+./base/display.css contains layout, typography rules:
+Only alter this file if you want to change the layout of the site. Please note that, any updates to this in future statusnet releases may not be compatible with your version.
+
+./default/css/display.css contains only the background images and colour rules:
+This file is a good basis for creating your own theme.
+
+Let's create a theme:
+
+1. To start off, copy over the default theme:
+cp -r default mytheme
+
+2. Edit your mytheme stylesheet:
+nano mytheme/css/display.css
+
+a) Search and replace your colours and background images, or
+b) Create your own layout either importing a separate stylesheet (e.g., change to @import url(base.css);) or simply place it before the rest of the rules.
+
+4. Set /config.php to load 'mytheme':
+$config['site']['theme'] = 'mytheme';