theme/README

   1 /** Howto: create a StatusNet theme
   2  *
   3  * @package   StatusNet
   4  * @author    Sarven Capadisli <csarven@status.net>
   5  * @copyright 2010 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 ==
  11 <pre><nowiki>
  12 base/css/
  13 base/css/display.css                #layout, typography rules
  14 base/images/                        #common icons, illustrations
  15 base/images/icons/icons-01.png      #main icons file (combined into a single file)
  16
  17 default/css/
  18 default/css/display.css             #imports the base stylesheet for layout and adds background images and colour rules
  19 default/logo.png                    #default site logo for this theme
  20 default/mobilelogo.png              #default logo for the mobile output
  21 default/default-avatar-mini.png     #24x24 default avatar for minilists
  22 default/default-avatar-stream.png   #48x48 default avatar for notice timelines
  23 default/default-avatar-profile.png  #96x96 default avatar for the profile page
  24 </nowiki></pre>
  25
  26
  27 == How to create your own theme ==
  28
  29
  30 You probably want to do one of the following:
  31
  32
  33 * If you just want to change the text, link, background, content, sidebar colours, background image:
  34 ** Do this from the Admin->Design settings (recommended!). You could also create a directory and a file structure like the default theme, search and replace with your own values. This is more work, but, you can do this if you plan to make additional *minimal* changes.
  35
  36
  37 * If you want to change the background images and colours:
  38 # Create a directory and a file structure like the default theme.
  39 # Have your stylesheet import base/css/display.css and add your own styles below. It is okay to add *minimal* changes here.
  40
  41
  42 * If you want to create a different layout, typography, background images and colours:
  43 ** Create your own theme directory (base or default) with stylesheets and images like.
  44
  45
  46 Finally, enable your theme by selecting it from the Admin->Design interface. You can set site's logo from here as well.
  47