slitaz-forge diff forum/vanilla/themes/slitaz-2/README.txt @ rev 2

move vanilla-config & themes in vanilla directory
author Eric Joseph-Alexandre <erjo@slitaz.org>
date Wed Dec 22 10:41:18 2010 +0100 (2010-12-22)
parents
children
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/forum/vanilla/themes/slitaz-2/README.txt	Wed Dec 22 10:41:18 2010 +0100
     1.3 @@ -0,0 +1,45 @@
     1.4 +How to create a theme:
     1.5 +
     1.6 +Part 1: CSS / Design
     1.7 +================================================================================
     1.8 +1. Copy this "default" theme folder and rename it to your new theme name.
     1.9 +2. Open the "about.php" file and edit the information to reflect your theme. Be
    1.10 +   sure to change the array key like this: $ThemeInfo['YourThemeNameHere'].
    1.11 +3. Create a "design" subfolder and copy /applications/dashboard/design/style.css 
    1.12 +   and /applications/vanilla/design/vanilla.css into it.
    1.13 +4. Any background images you want to continue using (like the star png images
    1.14 +   for bookmarking) should be copied along with their respective stylesheets.
    1.15 +5. Go to your Dashboard, Themes, and apply your new theme.
    1.16 +6. Edit the copied CSS files to look however you wish!
    1.17 +
    1.18 +Other things you should know:
    1.19 +
    1.20 + + All non-forum pages should be edited in the global "style.css" file.
    1.21 +
    1.22 + + If you want to edit the look & feel of the administrative screens, also 
    1.23 +   copy /applications/dashboard/design/admin.css in step 3. Similarly, you can 
    1.24 +   copy other CSS files like /applications/vanilla/design/vanillaprofile.css to
    1.25 +   customize those pages as well.
    1.26 +
    1.27 +
    1.28 +Part 2: HTML / Views
    1.29 +================================================================================
    1.30 +If you want to customize the HTML, you can edit that too. 
    1.31 +Our pages are made up of two parts:
    1.32 +
    1.33 + 1. Master Views - these represent everything that wraps the main content of the
    1.34 +   page. If all you want to do is add a menu or banner above Vanilla, this is
    1.35 +   all you need to alter. To do so, copy the default master view from
    1.36 +   /applications/dashboard/views/default.master.php to
    1.37 +   /themes/yourtheme/views/default.master.php and edit it there.
    1.38 +   
    1.39 + 2. Views - these represent all of the content in each page. Every application
    1.40 +   has a "views" folder that contains all of the HTML for every page. So, for
    1.41 +   example, if you wanted to edit the HTML for the Discussions list, you could
    1.42 +   copy the views from /applications/vanilla/views/discussions to
    1.43 +   /themes/yourtheme/views/discussions and edit them there.
    1.44 +
    1.45 +You can avoid naming conflicts between applications' views and specify which 
    1.46 +app a view is for by optionally adding a subfolder with the app's name in 
    1.47 +/themes/yourtheme/views/ (e.g.: /themes/yourtheme/views/appname/) and placing 
    1.48 +views there rather than directly in the "views" folder.
    1.49 \ No newline at end of file