From: Christopher Allan Webber <cwebber@dustycloud.org>
Date: Sun, 15 Jul 2012 03:58:42 +0000 (-0500)
Subject: Added a section describing how to do theming via simple CSS stuff!
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=62157a898f60fab7c82eb76b2969354f9f02390d;p=mediagoblin.git

Added a section describing how to do theming via simple CSS stuff!
---

diff --git a/docs/source/siteadmin/theming.rst b/docs/source/siteadmin/theming.rst
index 63beaf3c..086838bc 100644
--- a/docs/source/siteadmin/theming.rst
+++ b/docs/source/siteadmin/theming.rst
@@ -224,6 +224,30 @@ can put whatever in here, but restating the license choice clearly is
 probably a good idea.
 
 
+Simple theming by adding CSS
+============================
+
+Many themes won't require anything other than the ability to override
+some of MediaGoblin's core css.  Thankfully, doing so is easy if you
+combine the above steps!
+
+In your theme, do the following (make sure you make the necessary
+directories and cd to your theme's directory first):
+
+  $ cp /path/to/mediagoblin/mediagoblin/templates/mediagoblin/extra_head.html templates/mediagoblin/
+
+Great, now open that file and add something like this at the end:
+
+  <link rel="stylesheet" type="text/css"
+        href="{{ request.staticdirect('/css/theme.css', 'theme') }}"/>
+
+You can name the css file whatever you like.  Now make the directory
+for assets/css/ and add the file assets/css/theme.css
+
+You can now put custom CSS files in here and any CSS you add will
+override default MediaGoblin CSS.
+
+
 Packaging it up!
 ================