[[PageOutline(2-5,Contents,pullout)]]

= Set styles based on the styling of a single wiki page

== Description

This plugin allows a user to apply the styling of a selected wiki page to the entire Trac project. It does so by using the CSS file of the selected wiki page as the global CSS file for the Trac project. The CSS file is specified as `[/projectdir]/wikicss.css` in the project's `trac.ini` file and a `link` HTML header is inserted which directs browsers to it.

The action can be undone by removing or commenting out the line from the `trac.ini` file, without having to uninstall or deactivate the plugin.

This plugin was originally requested through #1714.

== Bugs/Feature Requests

Existing bugs and feature requests for WikiCssPlugin are 
[report:9?COMPONENT=WikiCssPlugin here].

If you have any issues, create a 
[/newticket?component=WikiCssPlugin new ticket].

[[TicketQuery(component=WikiCssPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:wikicssplugin here].

== Source

You can check out WikiCssPlugin from [/svn/wikicssplugin here] using Subversion, or [source:wikicssplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Configuration

Put the following into your configuration file `trac.ini`:
{{{#!ini
[wikicss]
# configure wiki page to be used as CSS file as `[/projectdir]/wikicss.css`.
wikipage = SiteStyle
}}}

This uses the `wiki:SiteStyle` page as CSS style file.

== Recent Changes

[[ChangeLog(wikicssplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:martin_s] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''