Edgewall Software

Version 3 (modified by Matthew Good <matt-good.net>, 16 years ago) ( diff )

added section for examples

This page documents the 1.4 (latest stable) release. Documentation for other releases can be found here.

Customizing the Trac Interface


This page is meant to give users suggestions on how they can customize the look of Trac. Topics on this page should cover editing the HTML templates and CSS files, but not the program code itself. The topics are intended to show users how they can modify the look of Trac to meet their specific needs. Suggestions for changes to Trac's interface applicable to all users should be filed as tickets, not listed on this page.

Site Header & Footer

In the environment folder for each Trac project there should be a directory called templates. This folder contains files site_header.cs and site_footer.cs. Users can customize their Trac site by placing HTML in these files. The content of these two files will be placed immediately following the opening <body> tag and immediately preceding the closing </body> tag of each page in the site.

These files may contain static HTML, though if users desire to have dynamically generated content they can make use of the ClearSilver templating language from within the pages as well.

Users can see ticket #332 and changeset [522] for more details.

Site CSS

Also in the enviroment's templates directory is the file site_css.cs. This file can contain Cascading Style Sheet rules that can override or extend the standard stylesheets.


Users can post code samples for how they have customized Trac's interface.

Note: See TracWiki for help on using the wiki.