theme/README

   1 /** Howto: create a StatusNet theme
   2  *
   3  * @package   StatusNet
   4  * @author    Sarven Capadisli <csarven@status.net>
   5  * @copyright 2009 StatusNet, Inc.
   6  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
   7  * @link      http://status.net/
   8  */
   9
  10 Location of key paths and files under theme/:
  11
  12 ./base/css/
  13 ./base/css/display.css
  14 ./base/images/
  15
  16 ./default/css/
  17 ./default/css/display.css
  18 ./default/images/
  19
  20 ./base/display.css contains layout, typography rules:
  21 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.
  22
  23 ./default/css/display.css contains only the background images and colour rules:
  24 This file is a good basis for creating your own theme.
  25
  26 Let's create a theme:
  27
  28 1. To start off, copy over the default theme:
  29 cp -r default mytheme
  30
  31 2. Edit your mytheme stylesheet:
  32 nano mytheme/css/display.css
  33
  34 a) Search and replace your colours and background images, or
  35 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.
  36
  37 4. Set /config.php to load 'mytheme':
  38 $config['site']['theme'] = 'mytheme';