]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - theme/README
Merge branch 'master' into testing
[quix0rs-gnu-social.git] / 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://creativecommons.org/licenses/by/3.0/ Creative Commons Attribution 3.0 unported
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 == How to create your own theme ==
27
28 You probably want to do one of the following:
29
30 * If you just want to change the text, link, background, content, sidebar colours, background image:
31 ** 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.
32
33 * If you want to change the background images and colours:
34 # Create a directory and a file structure like the default theme.
35 # Have your stylesheet import base/css/display.css and add your own styles below. It is okay to add *minimal* changes here.
36
37 * If you want to create a different layout, typography, background images and colours:
38 ** Create your own theme directory (base or default) with stylesheets and images like.
39
40 Finally, enable your theme by selecting it from the Admin->Design interface. You can set site's logo from here as well.
41