Added a section describing how to do theming via simple CSS stuff!
authorChristopher Allan Webber <cwebber@dustycloud.org>
Sun, 15 Jul 2012 03:58:42 +0000 (22:58 -0500)
committerChristopher Allan Webber <cwebber@dustycloud.org>
Sun, 15 Jul 2012 03:58:42 +0000 (22:58 -0500)
docs/source/siteadmin/theming.rst

index 63beaf3cf8ef0c9e1329347af39b7dbc86c5e2dc..086838bc25c3f412d8a0dce13652a24c86be2935 100644 (file)
@@ -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!
 ================