|Version 4 (modified by anonymous, 7 years ago)|
water garden supplies koi pond olive garden buy silk flower outdoor wall fountains flower arrangements send flowers birthday flower arrangements wedding flowers wedding flowers funeral flower arrangements olive garden wholesale fake flowers artificial flowers silk flowers flower girl dresses online flower shops anniversary flower wedding flowers better homes and gardens silk flower arrangements garden fountains dallas indoor wall fountains discount flowers flower girl dresses online flower shop funeral flower arrangements flower send flowers wholesale fake flowers artificial flowers silk flowers wall water fountains buy flowers send flowers flower shops outdoor garden fountains artificial flowers discount flower delivery flower arrangements christmas + blue flowers flower deliveries flowers olive garden wedding bouquet buy silk flower cheap flowers flower flower tattoos garden fountains savage garden cheap flower girl dresses flowers flower shops artificial plants or artificial flowers wedding flowers cookie bouquets send flowers garden fountains fort worth flower tattoos garden fountain buy silk flower carole bouquet buy flowers online wedding flower bouquets flower girl dresses birthday flower arrangements cookie bouquets wedding flowers artificial flower christmas flowers flower tattoos wholesale fake flowers artificial flowers silk flowers newest silk flower arrangements artificial flower flower wedding flowers flower flower flowers plastic flower pot flower girl baskets vancouver anniversary flower flower shops in texas flower arrangements international flower delivery send flowers cheap artificial flower wedding flowers flower pots flower send flowers cheap sympathy flowers buy flowers wedding flowers wedding flowers flower girl baskets flower girl dresses indoor wall fountains bridal bouquets flower pot tree stand flower girl dresses garden ridge savage garden vancouver anniversary flowers garden fountains cookie bouquets send flowers flower send flowers flower girl gifts busch gardens silk flower or cactus arrangement savage garden flower arrangements send flowers flower arrangements christmas + blue flowers pond supplies carole bouquet flower girl basket pond flower pot wedding favors silk flower or cactus arrangement flower girl dresses birthday flower arrangements flower girl gifts funeral flower arrangements flower arrangements flower tattoos flower delivery pond kits wedding flowers flower artificial plants or artificial flowers bridal bouquets wedding flowers funeral flower arrangements artificial orchids or flowers savage garden flower flower flower girl dresses olive garden newest silk flower arrangements funeral flower arrangements silk flower arrangements wedding flowers outdoor wall fountains flower girl dresses flower arrangements wedding flowers flower shop flower tattoos flower pot floor stand flower girl dresses wedding flowers send flowers buy flowers online flowers olive garden garden ridge christmas flower ponds petticoat pond flower pot wedding favors send flowers flowers fresh fruit and flower baskets petticoat pond flower deliveries outdoor wall fountains flower flower tattoos send flowers flowers flower girl dresses flower flower online flower ordering flower pots flower tattoos cheap silk flowers silk flower arrangements flower wedding flowers garden fountain flowers wedding flowers garden fountains flower pots flower girl dresses send flowers garden fountains funeral flower arrangements flowers garden fountain silk flower arrangements flower flower girl dresses flower girl basket send flowers artificial plant or artificial flower flower girl basket send flowers water garden supplies koi pond cookie bouquets busch gardens flower shop send flowers garden pond supplies flower girl dresses flowers outdoor garden fountains flowers generic viagra cheap ultracet butalbital cheap adipex online discount phentermine buy ambien online buy levitra buy xanax online online pharmacy tramadol soma online atenolol buy diazepam cialis ativan data celexa & discontinuation symptoms carisoprodol buying cheap fioricet buy online ultram soft tab tadalafil buy cheap fioricet buy tramadol ambien online adipex diet pills carisoprodol buying buy cheap ultram buy alprazolam online buy soma online buy cheap fioricet herbal viagra buy celexa butalbital prescription generic levitra ativan cheap xanax online discount phentermine valium online cheap diazepam tadalafil alternative atenolol and flushing carisoprodol buying buy viagra buy ultracet valium online buy alprazolam online ambien online cheap cialis online atenolol buy soma ativan buy online buy online carisoprodol buy xanax online tramadol phentermine online buy tadalafil buy cheap diazepam cheap ultram celexa butalbital prescription adipex prescriptions buy online ultracet soft tab tadalafil buy soma valium without prescription buy online carisoprodol buy xanax online buy fioricet online cheap ultracet buy online diazepam butalbital online buy levitra phentermine generic ambien adipex celexa & discontinuation symptoms buy atenolol ativan cialis herbal viagra buy tramadol drug ultracet viagra generic tadalafil xanax online buy online ultracet phentermine online alprazolam generic levitra buy ambien cheap soma adipex prescriptions tramadol butalbital online valium atenolol and flushing buy celexa cialis cheap fioricet carisoprodol buy online buy online ultram carisoprodol valium without prescription cheap adipex buy ambien drug ultracet buy viagra order cialis ativan buy online alprazolam online celexa & discontinuation symptoms online pharmacy tramadol butalbital buying carisoprodol buy online generic levitra buy diazepam atenolol and flushing drug fioricet side effects of xanax soft tab tadalafil buy soma cheap buy online celexa
Customizing the Trac Interface
Table of Contents
This page is meant to give users suggestions on how they can customize the look of Trac. Topics on this page 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.
Project Logo and Icon
The easiest parts of the Trac interface to customize are the logo and the site icon. Both of these can be configured with settings in trac.ini.
The logo or icon image should be put in a folder named "htdocs" in your project's environment folder. (Note: in projects created with a Trac version prior to 0.9 you will need to create this folder)
Now configure the appropriate section of your trac.ini:
Change the src setting to site/ followed by the name of your image file. The width and height settings should be modified to match your image's dimensions.
[header_logo] src = site/my_logo.gif alt = My Project width = 300 height = 100
Icons should be a 16x16 image in .gif or .ico format. Change the icon setting to site/ followed by the name of your icon file. Icons will typically be displayed by your web browser next to the site's URL and in the Bookmarks menu.
[project] icon = site/my_icon.ico
Note though that this icon is ignored by Internet Explorer, which only accepts a file named favicon.ico at the root of the host. To make the project icon work in both IE and other browsers, you can store the icon in the document root of the host, and reference it from trac.ini as follows:
[project] icon = /favicon.ico
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 adding the required HTML markup to 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, respectively.
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. When you need to see what variables are available to the template, append the query string ?hdfdump=1 to the URL of your Trac site. This will display a structured view of the template data.
The primary means to adjust the layout of a Trac site is by add CSS style rules that overlay the default rules. This is best done by editing the site_css.cs file in the enviroment's templates directory. The content of that template gets inserted into a <style type="text/css></style> element on every HTML page generated by Trac.
While you can add your custom style rules directory to the site_css.cs file, it is recommended that you simply reference an external style sheet, thereby enabling browsers to cache the CSS file instead of transmitting the rules with every response.
The following example would import a style sheet located in the style root directory of your host:
You can use a ClearSilver variable to reference a style sheet stored in the project environment's htdocs directory:
@import url(<?cs var:chrome.href ?>/site/style.css);
It is also possible to use your own modified versions of the Trac ClearSilver templates. Note though that this technique is not recommended because it makes upgrading Trac rather problematic: there are unfortunately several dependencies between the templates and the application code, such as the name of form fields and the structure of the template data, and these are likely to change between different versions of Trac.
If you absolutely need to use modified templates, copy the template files from the default templates directory (usually in found in $prefix/share/trac/templates) into the templates directory of the project environment. Then modify those copies to get the desired results.