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

= A theme based on python.org and The Python Papers

== Description

This is a theme that emulates the look of python.org and adds some graphical elements (under permission) found in [http://www.pythonpapers.org The Python Papers]. 

It requires the ThemeEnginePlugin. 

Everything was done by the authors of PyDotOrgTheme. The following features have been added:

  - Always show the banner, footer and mainnav, and context nav sections.
  - Prevent mainnav from overlapping with banner and page contents
  - Control resizing of logo image.
  - Include project name in banner
  - Nicer style and embellishments 

== Screenshot

Once the theme is installed and selected, it looks like this

[[Image(screenshot.2.png, 60%)]]

== Bugs/Feature Requests

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=PyTppThemePlugin&owner=olemis new ticket].
If you want to submit patches, please read the 
[wiki:olemis#Guidelinestocollaborate patch submission guidelines].

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

== Download

Download the zipped source ('''latest version''') from [http://pypi.python.org/pypi/TracPyTppTheme here]. Since [http://pypi.python.org/pypi/TracPyTppTheme/2.2.1 version 2.2.1] the entire page is shown.

In order to always show the banner, footer and context nav sections, you'll have to download [http://pypi.python.org/pypi/TracPyTppTheme/2.2.0 version 2.2.0].

== Source

You can check out PyTppThemePlugin from [http://trac-hacks.org/svn/pytppthemeplugin here] using Subversion, or [source:pytppthemeplugin browse the source] with Trac.

== Example

Enabling and using this plugin requires the following changes to you `trac.ini` file.

To enable:

{{{
#!ini 
[components]
pytpptheme.* = enabled
}}}

To use: 

{{{
#!ini
[theme]
theme = PyTpp
}}}

You can see '''the latest version''' in action [https://opensvn.csie.org/traccgi/swlcu here].

=== Sites using this theme

Some sites that use this theme:

  - [http://www.digitalchickenscratch.com/index.fcgi/ DIGITAL CHICKEN SCRATCH – Trac]
  - [http://www.kleinreich.de/trac/ Kleinreich.de]

== Recent Changes

[[ChangeLog(pytppthemeplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:olemis Olemis Lang] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' [wiki:abalter]