Modular styles manager
Description
This plugin simplifies the process of distributing and deploying themes and styles.
In the 0.10 version, the WebAdmin plugin is required.
Options
All of these are under [theme].
- theme
- Specify which theme to use.
- override_logo
- If set to true, the theme can override your header_logo settings with its own logo. (Note: This is true by default)
API Basics
Most themes should simply subclass ThemeBase (in themeengine.api). This works similarly to WikiMacroBase, use your theme name followed by "Theme" as the class name, and put the description as the class's docstring. There are a number of class variable you can define to affect how your theme will be loaded, if any is set to True, it will take on a default value (see below):
- header
- The path to the header template. (Defaults to templates/header.cs)
- footer
- The path to the footer template. (Defaults to templates/footer.cs)
- css
- The path to the CSS template. (Defaults to templates/css.cs)
- htdocs
- The folder containing the static content. (Defaults to htdocs)
- screenshot
- The path to the screenshot file. (Defaults to htdocs/screenshot.png)
- header_logo
- A dict containing the data normally in [header_logo] in trac.ini. (Defaults to {})
Packaging A Theme
For lack of a decent guide right now, check out some of the existing themes.
One request, when taking screenshots please make them of the first wiki page, preferably with its default content. Also please make them match the aspect ratio of 640x400.
Choosing a Theme
To select a theme you can either specify it in trac.ini (see below), or use the WebAdmin interface. The web interface does require JavaScript in your browser.
Bugs/Feature Requests
Existing bugs and feature requests for ThemeEnginePlugin are here.
If you have any issues, create a new ticket.
Download and Source
Download the zipped source from here. You can check out ThemeEnginePlugin from here using Subversion, or browse the source with Trac.
Example
To enable:
[components] themeengine.* = enabled
To specify a theme:
[theme] theme = <Name>
Recent Changes
[5930] by coderanger on 06/03/09 06:14:02
Allow disabling Trac CSS entirely. Fix JS.
[5482] by coderanger on 04/05/09 02:08:41
Working on adding a mainnav hover variable.
[5464] by coderanger on 04/02/09 05:17:12
Add CSS variables for mainnav. Update the omgponies theme.
[5449] by coderanger on 03/31/09 22:27:51
More fixes for compat with older themes.
Author/Contributors
Author: coderanger
Maintainer: coderanger
Contributors:
