Mercurial > p > roundup > code

comparison doc/customizing.txt @ 1952:c40ed9113285

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Applied Stefan Seefeld's html4/xhtml patch with some changes.
author Richard Jones <richard@users.sourceforge.net>
date Sat, 06 Dec 2003 00:00:54 +0000
parents 0798ce090450
children a71bc3a6f433
comparison
equal deleted inserted replaced
1951:767ff2a03eee 1952:c40ed9113285
1 =================== 1 ===================
2 Customising Roundup 2 Customising Roundup
3 =================== 3 ===================
4 4
5 :Version: $Revision: 1.105 $ 5 :Version: $Revision: 1.106 $
6 6
7 .. This document borrows from the ZopeBook section on ZPT. The original is at: 7 .. This document borrows from the ZopeBook section on ZPT. The original is at:
8 http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx 8 http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
9 9
10 .. contents:: 10 .. contents::
178 178
179 **MAIL_DEFAULT_CLASS** - ``'issue'`` or ``''`` 179 **MAIL_DEFAULT_CLASS** - ``'issue'`` or ``''``
180 Default class to use in the mailgw if one isn't supplied in email 180 Default class to use in the mailgw if one isn't supplied in email
181 subjects. To disable, comment out the variable below or leave it blank. 181 subjects. To disable, comment out the variable below or leave it blank.
182 182
183 **HTML_VERSION** - ``'html4'`` or ``'xhtml'``
184 HTML version to generate. The templates are html4 by default. If you
185 wish to make them xhtml, then you'll need to change this var to 'xhtml'
186 too so all auto-generated HTML is compliant.
187
183 The default config.py is given below - as you 188 The default config.py is given below - as you
184 can see, the MAIL_DOMAIN must be edited before any interaction with the 189 can see, the MAIL_DOMAIN must be edited before any interaction with the
185 tracker is attempted.:: 190 tracker is attempted.::
186 191
187 # roundup home is this package's directory 192 # roundup home is this package's directory
252 # Default class to use in the mailgw if one isn't supplied in email 257 # Default class to use in the mailgw if one isn't supplied in email
253 # subjects. To disable, comment out the variable below or leave it 258 # subjects. To disable, comment out the variable below or leave it
254 # blank. Examples: 259 # blank. Examples:
255 MAIL_DEFAULT_CLASS = 'issue' # use "issue" class by default 260 MAIL_DEFAULT_CLASS = 'issue' # use "issue" class by default
256 #MAIL_DEFAULT_CLASS = '' # disable (or just comment the var out) 261 #MAIL_DEFAULT_CLASS = '' # disable (or just comment the var out)
262
263 # HTML version to generate. The templates are html4 by default. If you
264 # wish to make them xhtml, then you'll need to change this var to 'xhtml'
265 # too so all auto-generated HTML is compliant.
266 HTML_VERSION = 'html4' # either 'html4' or 'xhtml'
257 267
258 # 268 #
259 # SECURITY DEFINITIONS 269 # SECURITY DEFINITIONS
260 # 270 #
261 # define the Roles that a user gets when they register with the 271 # define the Roles that a user gets when they register with the
1051 1061
1052 1062
1053 1063
1054 Default templates 1064 Default templates
1055 ----------------- 1065 -----------------
1066
1067 The default templates are html4 compliant. If you wish to change them to be
1068 xhtml compliant, you'll need to change the ``HTML_VERSION`` configuration
1069 variable in ``config.py`` to ``'xhtml'`` instead of ``'html4'``.
1056 1070
1057 Most customisation of the web view can be done by modifying the 1071 Most customisation of the web view can be done by modifying the
1058 templates in the tracker ``'html'`` directory. There are several types 1072 templates in the tracker ``'html'`` directory. There are several types
1059 of files in there. The *minimal* template includes: 1073 of files in there. The *minimal* template includes:
1060 1074
Roundup Issue Tracker: http://roundup-tracker.org/