wiki:AddHeadersPlugin

Version 3 (modified by Martin Scharrer, 15 years ago) (diff)

Added usage information.

Add HTML Headers to Trac Pages in a simple way

Description

This plug-in allows Trac 0.11 server admins to add script and link headers into all trac pages without having to create a Chrome template file. This allows the easy usage of own JavaScript and CSS files. Also all other kinds of link headers can be added.

Installation

Copy the single python file into the 'plugins' directory of your trac installation and add the following into the config file (normally 'conf/trac.ini'):

[components]
addheaders.* = enabled

Usage

The plugin is controlled over settings the Trac config file (normally 'conf/trac.ini'). All settings must be put in the section [addheaders].

Settings

default_base = <path relative to base URL> (default: 'site/')
This is used as default base of the files relative to the base URL (which is e.g. http://trac.example.org/project1/). Please note that URL paths not local file paths are used. The default is site/ which is the relative URL for the htdocs directory in your $TRAC_PROJECT_DIR.
default_script_base = <path relative to base URL> (default: default_base)
To provide an different default path for scripts.
default_style_base = <path relative to base URL> (default: default_base)
To provide an different default path for style files.
add_scripts = <name1>,<name2>,...
Will add script tags for all given names. The mime-type and filename can be defined by:
  • <name>.type = <MIME-type> (default: 'text/javascript')
  • <name>.filename = <filename incl. path> (default: default_script_base<name>.js)
add_styles = <name1>,<name2>,...
Will add CSS link tags for all given names. The mime-type and filename can be defined by:
  • <name>.type = <MIME-type> (default: 'text/css')
  • <name>.filename = <filename incl. path> (default: default_style_base<name>.css)
add_link = <name1>,<name2>,...
Will add general link tags for all given names. There exists no default setting.

The following settings are mandatory:
  • <name>.rel = <Relation of the link>
  • <name>.href = <Relative URL of the link>

The following settings are obtional:
  • <name>.title = <Link title>
  • <name>.type = <MIME-type of linked content>
  • <name>.class = <(CSS?) class of link>

See also the example below.

Bugs/Feature Requests

Existing bugs and feature requests for AddHeadersPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from [download:addheadersplugin here].

Source

You can check out AddHeadersPlugin from here using Subversion, or browse the source with Trac.

Example

The following example shows how to add files for a multi-style implementation: The JavaScript file is located at $TRAC_PROJECT_DIR/htdocs/js/multistyle.js and all CSS files are located at $TRAC_PROJECT_DIR/htdocs/css/. A general style file 'common.css' is included which holds all common style definition. The default style is in 'default.css' and the alternative styles in 'theme1.css' and 'theme2.css'. Please note that general CSS files are added using add_styles while the others using add_links. This has HTML and Trac API related reasons.

# in trac.ini
[addheaders]
default_style_base  = site/css/
default_script_base = site/js/

add_scripts  = multistyle
add_styles   = common
add_links    = style0,style1,style2

style0.rel   = stylesheet
style0.type  = text/css
style0.title = default
style0.href  = /chrome/site/default.css

style1.rel   = alternate stylesheet
style1.type  = text/css
style1.title = theme1
style1.href  = /chrome/site/theme1.css

style2.rel   = alternate stylesheet
style2.type  = text/css
style2.title = theme2
style2.href  = /chrome/site/theme2.css

Recent Changes

17136 by rjollos on 2018-04-16 19:54:35
TracAddHeadersPlugin 0.4: Conform to PEP8
15264 by rjollos on 2016-02-11 04:22:34
Remove unnecessary svn:mime-type on py files

svn:mime-type was set to "plain" for many files.

9844 by martin_s on 2011-02-08 17:33:08
tracaddheaders/plugin.py
Made meta name attribute default to the name used in the config file.
(more)

Author/Contributors

Author: martin_s
Contributors: