= Modular styles manager = == Description == This plugin simplifies the process of distributing and deploying themes and styles. == API Basics == Most themes should simply subclass `ThemeBase` (in `themeengine.api`). This works similarly to `WikiMacroBase`, use you 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 [wiki:GamedevTheme the] [wiki:ConsultantTheme existing] [wiki:PyDotOrgTheme 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 ration of 640x400. == Bugs/Feature Requests == Existing bugs and feature requests for ThemeEnginePlugin are [report:9?COMPONENT=ThemeEnginePlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=ThemeEnginePlugin&owner=coderanger new ticket]. == Download == Download the zipped source from [download:themeengineplugin here]. == Source == You can check out ThemeEnginePlugin from [http://trac-hacks.org/svn/themeengineplugin here] using Subversion, or [source:themeengineplugin browse the source] with Trac. == Example == To enable: {{{ [components] themeengine.* = enabled }}} To specify a theme: {{{ [theme] theme = }}} == Recent Changes == [[ChangeLog(themeengineplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:coderanger] [[BR]] '''Contributors:'''