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

= Set CSS styles using a wiki page

== Description

This plugin allows one wiki page to be used as global CSS style file for Trac. The CSS file is provided at `[/projectdir]/wikicss.css` and a `link` HTML header is inserted which directs browsers to it.

This plugin got requested by Request-a-Hack #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.
There is also a version on [pypi:TracWikiCssPlugin/0.1.6958 PyPi].

== Installation

 1. With easy_install:
 {{{#!sh
easy_install http://trac-hacks.org/svn/wikicssplugin/0.11
}}}
 1. Restart web server (in this example using Apache on Ubuntu OS):
 {{{#!sh
sudo /etc/init.d/apache2 restart
}}}
 1. Enable plugin through {{{../admin/general/plugin}}} or modify your `trac.ini` file to include:
 {{{#!ini
[components]
tracwikicss.* = enabled
}}}

== 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:'''