| 20 | | [[TracIni]] |
| | 20 | {{{#!html |
| | 21 | <div class="tracini"><h2 id="attachment-section">[attachment]</h2><table class="wiki"><tbody><tr><td><tt>max_size</tt></td><td>Maximum allowed file size (in bytes) for ticket and wiki |
| | 22 | attachments.</td></tr><tr><td><tt>render_unsafe_content</tt></td><td>Whether attachments should be rendered in the browser, or |
| | 23 | only made downloadable. |
| | 24 | |
| | 25 | Pretty much any file may be interpreted as HTML by the browser, |
| | 26 | which allows a malicious user to attach a file containing cross-site |
| | 27 | scripting attacks. |
| | 28 | |
| | 29 | For public sites where anonymous users can create attachments it is |
| | 30 | recommended to leave this option disabled (which is the default).</td></tr></tbody></table><h2 id="browser-section">[browser]</h2><table class="wiki"><tbody><tr><td><tt>color_scale</tt></td><td>Enable colorization of the <i>age</i> column. |
| | 31 | |
| | 32 | This uses the same color scale as the source code annotation: |
| | 33 | blue is older, red is newer. |
| | 34 | (<i>since 0.11</i>)</td></tr><tr><td><tt>downloadable_paths</tt></td><td>List of repository paths that can be downloaded. |
| | 35 | |
| | 36 | Leave the option empty if you want to disable all downloads, otherwise |
| | 37 | set it to a comma-separated list of authorized paths (those paths are |
| | 38 | glob patterns, i.e. "*" can be used as a wild card) |
| | 39 | (<i>since 0.10</i>)</td></tr><tr><td><tt>hide_properties</tt></td><td>Comma-separated list of version control properties to hide from |
| | 40 | the repository browser. |
| | 41 | (<i>since 0.9</i>)</td></tr><tr><td><tt>intermediate_color</tt></td><td>(r,g,b) color triple to use for the color corresponding |
| | 42 | to the intermediate color, if two linear interpolations are used |
| | 43 | for the color scale (see <tt>intermediate_point</tt>). |
| | 44 | If not set, the intermediate color between <tt>oldest_color</tt> and |
| | 45 | <tt>newest_color</tt> will be used. |
| | 46 | (<i>since 0.11</i>)</td></tr><tr><td><tt>intermediate_point</tt></td><td>If set to a value between 0 and 1 (exclusive), this will be the |
| | 47 | point chosen to set the <tt>intermediate_color</tt> for interpolating |
| | 48 | the color value. |
| | 49 | (<i>since 0.11</i>)</td></tr><tr><td><tt>newest_color</tt></td><td>(r,g,b) color triple to use for the color corresponding |
| | 50 | to the newest color, for the color scale used in <i>blame</i> or |
| | 51 | the browser <i>age</i> column if <tt>color_scale</tt> is enabled. |
| | 52 | (<i>since 0.11</i>)</td></tr><tr><td><tt>oldest_color</tt></td><td>(r,g,b) color triple to use for the color corresponding |
| | 53 | to the oldest color, for the color scale used in <i>blame</i> or |
| | 54 | the browser <i>age</i> column if <tt>color_scale</tt> is enabled. |
| | 55 | (<i>since 0.11</i>)</td></tr><tr><td><tt>oneliner_properties</tt></td><td>Comma-separated list of version control properties to render |
| | 56 | as oneliner wiki content in the repository browser. |
| | 57 | |
| | 58 | (<i>since 0.11</i>)</td></tr><tr><td><tt>render_unsafe_content</tt></td><td>Whether raw files should be rendered in the browser, or only made |
| | 59 | downloadable. |
| | 60 | |
| | 61 | Pretty much any file may be interpreted as HTML by the browser, |
| | 62 | which allows a malicious user to create a file containing cross-site |
| | 63 | scripting attacks. |
| | 64 | |
| | 65 | For open repositories where anyone can check-in a file, it is |
| | 66 | recommended to leave this option disabled (which is the default).</td></tr><tr><td><tt>wiki_properties</tt></td><td>Comma-separated list of version control properties to render |
| | 67 | as wiki content in the repository browser. |
| | 68 | |
| | 69 | (<i>since 0.11</i>)</td></tr></tbody></table><h2 id="changeset-section">[changeset]</h2><table class="wiki"><tbody><tr><td><tt>max_diff_bytes</tt></td><td>Maximum total size in bytes of the modified files (their old size |
| | 70 | plus their new size) for which the changeset view will attempt to show |
| | 71 | the diffs inlined (<i>since 0.10</i>).</td></tr><tr><td><tt>max_diff_files</tt></td><td>Maximum number of modified files for which the changeset view will |
| | 72 | attempt to show the diffs inlined (<i>since 0.10</i>).</td></tr><tr><td><tt>wiki_format_messages</tt></td><td>Whether wiki formatting should be applied to changeset messages. |
| | 73 | |
| | 74 | If this option is disabled, changeset messages will be rendered as |
| | 75 | pre-formatted text.</td></tr></tbody></table><h2 id="header_logo-section">[header_logo]</h2><table class="wiki"><tbody><tr><td><tt>alt</tt></td><td>Alternative text for the header logo.</td></tr><tr><td><tt>height</tt></td><td>Height of the header logo image in pixels.</td></tr><tr><td><tt>link</tt></td><td>URL to link to from header logo.</td></tr><tr><td><tt>src</tt></td><td>URL of the image to use as header logo.</td></tr><tr><td><tt>width</tt></td><td>Width of the header logo image in pixels.</td></tr></tbody></table><h2 id="inherit-section">[inherit]</h2><table class="wiki"><tbody><tr><td><tt>plugins_dir</tt></td><td>Path of the directory containing additional plugins. |
| | 76 | |
| | 77 | Plugins in that directory are loaded in addition to those in the |
| | 78 | directory of the environment <tt>plugins</tt>, with this one taking |
| | 79 | precedence. |
| | 80 | |
| | 81 | (<i>since 0.11</i>)</td></tr><tr><td><tt>templates_dir</tt></td><td>Path to the shared templates directory. |
| | 82 | |
| | 83 | Templates in that directory are loaded in addition to those in the |
| | 84 | environments <tt>templates</tt> directory, but the latter take precedence. |
| | 85 | |
| | 86 | (<i>since 0.11</i>)</td></tr></tbody></table><h2 id="logging-section">[logging]</h2><table class="wiki"><tbody><tr><td><tt>log_file</tt></td><td>If <tt>log_type</tt> is <tt>file</tt>, this should be a path to the log-file.</td></tr><tr><td><tt>log_format</tt></td><td>Custom logging format. |
| | 87 | |
| | 88 | If nothing is set, the following will be used: |
| | 89 | |
| | 90 | Trac[$(module)s] $(levelname)s: $(message)s |
| | 91 | |
| | 92 | In addition to regular key names supported by the Python logger library |
| | 93 | library (see <a class="ext-link" href="http://docs.python.org/lib/node422.html"><span class="icon"> </span>http://docs.python.org/lib/node422.html</a>), one could use: |
| | 94 | - $(path)s the path for the current environment |
| | 95 | - $(basename)s the last path component of the current environment |
| | 96 | - $(project)s the project name |
| | 97 | |
| | 98 | Note the usage of <tt>$(...)s</tt> instead of <tt>%(...)s</tt> as the latter form |
| | 99 | would be interpreted by the <a class="missing wiki" href="/wiki/ConfigParser" rel="nofollow">ConfigParser?</a> itself. |
| | 100 | |
| | 101 | Example: |
| | 102 | <tt>($(thread)d) Trac[$(basename)s:$(module)s] $(levelname)s: $(message)s</tt> |
| | 103 | |
| | 104 | <i>(since 0.10.5)</i></td></tr><tr><td><tt>log_level</tt></td><td>Level of verbosity in log. |
| | 105 | |
| | 106 | Should be one of (<tt>CRITICAL</tt>, <tt>ERROR</tt>, <tt>WARN</tt>, <tt>INFO</tt>, <tt>DEBUG</tt>).</td></tr><tr><td><tt>log_type</tt></td><td>Logging facility to use. |
| | 107 | |
| | 108 | Should be one of (<tt>none</tt>, <tt>file</tt>, <tt>stderr</tt>, <tt>syslog</tt>, <tt>winlog</tt>).</td></tr></tbody></table><h2 id="milestone-section">[milestone]</h2><table class="wiki"><tbody><tr><td><tt>stats_provider</tt></td><td>Name of the component implementing <tt>ITicketGroupStatsProvider</tt>, |
| | 109 | which is used to collect statistics on groups of tickets for display |
| | 110 | in the milestone views.</td></tr></tbody></table><h2 id="mimeviewer-section">[mimeviewer]</h2><table class="wiki"><tbody><tr><td><tt>enscript_modes</tt></td><td>List of additional MIME types known by Enscript. |
| | 111 | For each, a tuple <tt>mimetype:mode:quality</tt> has to be |
| | 112 | specified, where <tt>mimetype</tt> is the MIME type, |
| | 113 | <tt>mode</tt> is the corresponding Enscript mode to be used |
| | 114 | for the conversion and <tt>quality</tt> is the quality ratio |
| | 115 | associated to this conversion. |
| | 116 | That can also be used to override the default |
| | 117 | quality ratio used by the Enscript render, which is 2 |
| | 118 | (<i>since 0.10</i>).</td></tr><tr><td><tt>enscript_path</tt></td><td>Path to the Enscript executable.</td></tr><tr><td><tt>max_preview_size</tt></td><td>Maximum file size for HTML preview. (<i>since 0.9</i>)</td></tr><tr><td><tt>mime_map</tt></td><td>List of additional MIME types and keyword mappings. |
| | 119 | Mappings are comma-separated, and for each MIME type, |
| | 120 | there's a colon (":") separated list of associated keywords |
| | 121 | or file extensions. (<i>since 0.10</i>)</td></tr><tr><td><tt>php_path</tt></td><td>Path to the PHP executable (<i>since 0.9</i>).</td></tr><tr><td><tt>pygments_default_style</tt></td><td>The default style to use for Pygments syntax highlighting.</td></tr><tr><td><tt>pygments_modes</tt></td><td>List of additional MIME types known by Pygments. |
| | 122 | |
| | 123 | For each, a tuple <tt>mimetype:mode:quality</tt> has to be |
| | 124 | specified, where <tt>mimetype</tt> is the MIME type, |
| | 125 | <tt>mode</tt> is the corresponding Pygments mode to be used |
| | 126 | for the conversion and <tt>quality</tt> is the quality ratio |
| | 127 | associated to this conversion. That can also be used |
| | 128 | to override the default quality ratio used by the |
| | 129 | Pygments render.</td></tr><tr><td><tt>tab_width</tt></td><td>Displayed tab width in file preview. (<i>since 0.9</i>)</td></tr><tr><td><tt>treat_as_binary</tt></td><td>Comma-separated list of MIME types that should be treated as |
| | 130 | binary data. (<i>since 0.11.5</i>)</td></tr></tbody></table><h2 id="notification-section">[notification]</h2><table class="wiki"><tbody><tr><td><tt>admit_domains</tt></td><td>Comma-separated list of domains that should be considered as |
| | 131 | valid for email addresses (such as localdomain)</td></tr><tr><td><tt>always_notify_owner</tt></td><td>Always send notifications to the ticket owner (<i>since 0.9</i>).</td></tr><tr><td><tt>always_notify_reporter</tt></td><td>Always send notifications to any address in the <i>reporter</i> |
| | 132 | field.</td></tr><tr><td><tt>always_notify_updater</tt></td><td>Always send notifications to the person who causes the ticket |
| | 133 | property change and to any previous updater of that ticket.</td></tr><tr><td><tt>ignore_domains</tt></td><td>Comma-separated list of domains that should not be considered |
| | 134 | part of email addresses (for usernames with Kerberos domains)</td></tr><tr><td><tt>mime_encoding</tt></td><td>Specifies the MIME encoding scheme for emails. |
| | 135 | |
| | 136 | Valid options are 'base64' for Base64 encoding, 'qp' for |
| | 137 | Quoted-Printable, and 'none' for no encoding, in which case mails will |
| | 138 | be sent as 7bit if the content is all ASCII, or 8bit otherwise. |
| | 139 | (<i>since 0.10</i>)</td></tr><tr><td><tt>notify_on_failed_build</tt></td><td>Notify if bitten build fails.</td></tr><tr><td><tt>notify_on_successful_build</tt></td><td>Notify if bitten build succeeds.</td></tr><tr><td><tt>smtp_always_bcc</tt></td><td>Email address(es) to always send notifications to, |
| | 140 | addresses do not appear publicly (Bcc:). (<i>since 0.10</i>).</td></tr><tr><td><tt>smtp_always_cc</tt></td><td>Email address(es) to always send notifications to, |
| | 141 | addresses can be seen by all recipients (Cc:).</td></tr><tr><td><tt>smtp_default_domain</tt></td><td>Default host/domain to append to address that do not specify one</td></tr><tr><td><tt>smtp_enabled</tt></td><td>Enable SMTP (email) notification.</td></tr><tr><td><tt>smtp_from</tt></td><td>Sender address to use in notification emails.</td></tr><tr><td><tt>smtp_from_name</tt></td><td>Sender name to use in notification emails.</td></tr><tr><td><tt>smtp_password</tt></td><td>Password for SMTP server. (<i>since 0.9</i>).</td></tr><tr><td><tt>smtp_port</tt></td><td>SMTP server port to use for email notification.</td></tr><tr><td><tt>smtp_replyto</tt></td><td>Reply-To address to use in notification emails.</td></tr><tr><td><tt>smtp_server</tt></td><td>SMTP server hostname to use for email notifications.</td></tr><tr><td><tt>smtp_subject_prefix</tt></td><td>Text to prepend to subject line of notification emails. |
| | 142 | |
| | 143 | If the setting is not defined, then the [$project_name] prefix. |
| | 144 | If no prefix is desired, then specifying an empty option |
| | 145 | will disable it. (<i>since 0.10.1</i>).</td></tr><tr><td><tt>smtp_user</tt></td><td>Username for SMTP server. (<i>since 0.9</i>).</td></tr><tr><td><tt>ticket_subject_template</tt></td><td>A Genshi text template snippet used to get the notification subject. |
| | 146 | |
| | 147 | By default, the subject template is <tt>$prefix #$ticket.id: $summary</tt>. |
| | 148 | <tt>$prefix</tt> being the value of the <tt>smtp_subject_prefix</tt> option. |
| | 149 | <i>(since 0.11)</i></td></tr><tr><td><tt>use_public_cc</tt></td><td>Recipients can see email addresses of other CC'ed recipients. |
| | 150 | |
| | 151 | If this option is disabled (the default), recipients are put on BCC |
| | 152 | (<i>since 0.10</i>).</td></tr><tr><td><tt>use_short_addr</tt></td><td>Permit email address without a host/domain (i.e. username only) |
| | 153 | |
| | 154 | The SMTP server should accept those addresses, and either append |
| | 155 | a FQDN or use local delivery (<i>since 0.10</i>).</td></tr><tr><td><tt>use_tls</tt></td><td>Use SSL/TLS to send notifications (<i>since 0.10</i>).</td></tr></tbody></table><h2 id="project-section">[project]</h2><table class="wiki"><tbody><tr><td><tt>admin</tt></td><td>E-Mail address of the project's administrator.</td></tr><tr><td><tt>admin_trac_url</tt></td><td>Base URL of a Trac instance where errors in this Trac should be |
| | 156 | reported. |
| | 157 | |
| | 158 | This can be an absolute or relative URL, or '.' to reference this |
| | 159 | Trac instance. An empty value will disable the reporting buttons. |
| | 160 | (<i>since 0.11.3</i>)</td></tr><tr><td><tt>descr</tt></td><td>Short description of the project.</td></tr><tr><td><tt>footer</tt></td><td>Page footer text (right-aligned).</td></tr><tr><td><tt>icon</tt></td><td>URL of the icon of the project.</td></tr><tr><td><tt>name</tt></td><td>Name of the project.</td></tr><tr><td><tt>url</tt></td><td>URL of the main project web site, usually the website in which |
| | 161 | the <tt>base_url</tt> resides.</td></tr></tbody></table><h2 id="query-section">[query]</h2><table class="wiki"><tbody><tr><td><tt>default_anonymous_query</tt></td><td>The default query for anonymous users. The query is either |
| | 162 | in <a class="wiki" href="/wiki/TracQuery#QueryLanguage">query language</a> syntax, or a URL query |
| | 163 | string starting with <tt>?</tt> as used in <tt>query:</tt> |
| | 164 | <a class="wiki" href="/wiki/TracQuery#UsingTracLinks">Trac links</a>. |
| | 165 | (<i>since 0.11.2</i>)</td></tr><tr><td><tt>default_query</tt></td><td>The default query for authenticated users. The query is either |
| | 166 | in <a class="wiki" href="/wiki/TracQuery#QueryLanguage">query language</a> syntax, or a URL query |
| | 167 | string starting with <tt>?</tt> as used in <tt>query:</tt> |
| | 168 | <a class="wiki" href="/wiki/TracQuery#UsingTracLinks">Trac links</a>. |
| | 169 | (<i>since 0.11.2</i>)</td></tr><tr><td><tt>items_per_page</tt></td><td>Number of tickets displayed per page in ticket queries, |
| | 170 | by default (<i>since 0.11</i>)</td></tr></tbody></table><h2 id="report-section">[report]</h2><table class="wiki"><tbody><tr><td><tt>items_per_page</tt></td><td>Number of tickets displayed per page in ticket reports, |
| | 171 | by default (<i>since 0.11</i>)</td></tr><tr><td><tt>items_per_page_rss</tt></td><td>Number of tickets displayed in the rss feeds for reports |
| | 172 | (<i>since 0.11</i>)</td></tr></tbody></table><h2 id="revisionlog-section">[revisionlog]</h2><table class="wiki"><tbody><tr><td><tt>default_log_limit</tt></td><td>Default value for the limit argument in the <a class="wiki" href="/wiki/TracRevisionLog">TracRevisionLog</a> |
| | 173 | (<i>since 0.11</i>).</td></tr></tbody></table><h2 id="roadmap-section">[roadmap]</h2><table class="wiki"><tbody><tr><td><tt>stats_provider</tt></td><td>Name of the component implementing <tt>ITicketGroupStatsProvider</tt>, |
| | 174 | which is used to collect statistics on groups of tickets for display |
| | 175 | in the roadmap views.</td></tr></tbody></table><h2 id="search-section">[search]</h2><table class="wiki"><tbody><tr><td><tt>min_query_length</tt></td><td>Minimum length of query string allowed when performing a search.</td></tr></tbody></table><h2 id="svn-section">[svn]</h2><table class="wiki"><tbody><tr><td><tt>branches</tt></td><td>Comma separated list of paths categorized as branches. |
| | 176 | If a path ends with '*', then all the directory entries found below |
| | 177 | that path will be included. |
| | 178 | Example: <tt>/trunk, /branches/*, /projectAlpha/trunk, /sandbox/*</tt></td></tr><tr><td><tt>tags</tt></td><td>Comma separated list of paths categorized as tags. |
| | 179 | |
| | 180 | If a path ends with '*', then all the directory entries found below |
| | 181 | that path will be included. |
| | 182 | Example: <tt>/tags/*, /projectAlpha/tags/A-1.0, /projectAlpha/tags/A-v1.1</tt></td></tr></tbody></table><h2 id="ticket-section">[ticket]</h2><table class="wiki"><tbody><tr><td><tt>default_cc</tt></td><td>Default cc: list for newly created tickets.</td></tr><tr><td><tt>default_component</tt></td><td>Default component for newly created tickets.</td></tr><tr><td><tt>default_description</tt></td><td>Default description for newly created tickets.</td></tr><tr><td><tt>default_keywords</tt></td><td>Default keywords for newly created tickets.</td></tr><tr><td><tt>default_milestone</tt></td><td>Default milestone for newly created tickets.</td></tr><tr><td><tt>default_owner</tt></td><td>Default owner for newly created tickets.</td></tr><tr><td><tt>default_priority</tt></td><td>Default priority for newly created tickets.</td></tr><tr><td><tt>default_resolution</tt></td><td>Default resolution for resolving (closing) tickets |
| | 183 | (<i>since 0.11</i>).</td></tr><tr><td><tt>default_severity</tt></td><td>Default severity for newly created tickets.</td></tr><tr><td><tt>default_summary</tt></td><td>Default summary (title) for newly created tickets.</td></tr><tr><td><tt>default_type</tt></td><td>Default type for newly created tickets (<i>since 0.9</i>).</td></tr><tr><td><tt>default_version</tt></td><td>Default version for newly created tickets.</td></tr><tr><td><tt>max_comment_size</tt></td><td>Don't accept tickets with a too big comment. |
| | 184 | (<i>since 0.11.2</i>)</td></tr><tr><td><tt>max_description_size</tt></td><td>Don't accept tickets with a too big description. |
| | 185 | (<i>since 0.11</i>).</td></tr><tr><td><tt>preserve_newlines</tt></td><td>Whether Wiki formatter should respect the new lines present |
| | 186 | in the Wiki text. |
| | 187 | If set to 'default', this is equivalent to 'yes' for new environments |
| | 188 | but keeps the old behavior for upgraded environments (i.e. 'no'). |
| | 189 | (<i>since 0.11</i>).</td></tr><tr><td><tt>restrict_owner</tt></td><td>Make the owner field of tickets use a drop-down menu. |
| | 190 | Be sure to understand the performance implications before activating |
| | 191 | this option. See |
| | 192 | <a class="wiki" href="/wiki/TracTickets#Assign-toasDrop-DownList">Assign-to as Drop-Down List</a> |
| | 193 | (<i>since 0.9</i>).</td></tr><tr><td><tt>workflow</tt></td><td>Ordered list of workflow controllers to use for ticket actions |
| | 194 | (<i>since 0.11</i>).</td></tr></tbody></table><h2 id="timeline-section">[timeline]</h2><table class="wiki"><tbody><tr><td><tt>abbreviated_messages</tt></td><td>Whether wiki-formatted event messages should be truncated or not. |
| | 195 | |
| | 196 | This only affects the default rendering, and can be overriden by |
| | 197 | specific event providers, see their own documentation. |
| | 198 | (<i>Since 0.11</i>)</td></tr><tr><td><tt>changeset_collapse_events</tt></td><td>Whether consecutive changesets from the same author having |
| | 199 | exactly the same message should be presented as one event. |
| | 200 | That event will link to the range of changesets in the log view. |
| | 201 | (<i>since 0.11</i>)</td></tr><tr><td><tt>changeset_long_messages</tt></td><td>Whether wiki-formatted changeset messages should be multiline or not. |
| | 202 | |
| | 203 | If this option is not specified or is false and <tt>wiki_format_messages</tt> |
| | 204 | is set to true, changeset messages will be single line only, losing |
| | 205 | some formatting (bullet points, etc).</td></tr><tr><td><tt>changeset_show_files</tt></td><td>Number of files to show (<tt>-1</tt> for unlimited, <tt>0</tt> to disable). |
| | 206 | |
| | 207 | This can also be <tt>location</tt>, for showing the common prefix for the |
| | 208 | changed files. (since 0.11).</td></tr><tr><td><tt>default_daysback</tt></td><td>Default number of days displayed in the Timeline, in days. |
| | 209 | (<i>since 0.9.</i>)</td></tr><tr><td><tt>max_daysback</tt></td><td>Maximum number of days (-1 for unlimited) displayable in the |
| | 210 | Timeline. (<i>since 0.11</i>)</td></tr><tr><td><tt>newticket_formatter</tt></td><td>Which formatter flavor (e.g. 'html' or 'oneliner') should be |
| | 211 | used when presenting the description for new tickets. |
| | 212 | If 'oneliner', the [timeline] abbreviated_messages option applies. |
| | 213 | (<i>since 0.11</i>).</td></tr><tr><td><tt>ticket_show_details</tt></td><td>Enable the display of all ticket changes in the timeline, not only |
| | 214 | open / close operations (<i>since 0.9</i>).</td></tr></tbody></table><h2 id="trac-section">[trac]</h2><table class="wiki"><tbody><tr><td><tt>authz_file</tt></td><td>Path to Subversion |
| | 215 | <a class="ext-link" href="http://svnbook.red-bean.com/en/1.1/ch06s04.html#svn-ch-6-sect-4.4.2"><span class="icon"> </span>authorization (authz) file</a></td></tr><tr><td><tt>authz_module_name</tt></td><td>The module prefix used in the authz_file.</td></tr><tr><td><tt>auto_reload</tt></td><td>Automatically reload template files after modification.</td></tr><tr><td><tt>backup_dir</tt></td><td>Database backup location</td></tr><tr><td><tt>base_url</tt></td><td>Reference URL for the Trac deployment. |
| | 216 | |
| | 217 | This is the base URL that will be used when producing documents that |
| | 218 | will be used outside of the web browsing context, like for example |
| | 219 | when inserting URLs pointing to Trac resources in notification |
| | 220 | e-mails.</td></tr><tr><td><tt>check_auth_ip</tt></td><td>Whether the IP address of the user should be checked for |
| | 221 | authentication (<i>since 0.9</i>).</td></tr><tr><td><tt>database</tt></td><td>Database connection |
| | 222 | <a class="wiki" href="/wiki/TracEnvironment#DatabaseConnectionStrings">string</a> for this |
| | 223 | project</td></tr><tr><td><tt>debug_sql</tt></td><td>Show the SQL queries in the Trac log, at DEBUG level. |
| | 224 | <i>(Since 0.11.5)</i></td></tr><tr><td><tt>default_charset</tt></td><td>Charset to be used when in doubt.</td></tr><tr><td><tt>default_handler</tt></td><td>Name of the component that handles requests to the base URL. |
| | 225 | |
| | 226 | Options include <tt>TimelineModule</tt>, <tt>RoadmapModule</tt>, <tt>BrowserModule</tt>, |
| | 227 | <tt>QueryModule</tt>, <tt>ReportModule</tt>, <tt>TicketModule</tt> and <tt>WikiModule</tt>. The |
| | 228 | default is <tt>WikiModule</tt>. (<i>since 0.9</i>)</td></tr><tr><td><tt>default_timezone</tt></td><td>The default timezone to use</td></tr><tr><td><tt>htdocs_location</tt></td><td>Base URL of the core static resources.</td></tr><tr><td><tt>ignore_auth_case</tt></td><td>Whether login names should be converted to lower case |
| | 229 | (<i>since 0.9</i>).</td></tr><tr><td><tt>mainnav</tt></td><td>Order of the items to display in the <tt>mainnav</tt> navigation bar, |
| | 230 | listed by IDs. See also <a class="missing wiki" href="/wiki/TracNavigation" rel="nofollow">TracNavigation?</a>.</td></tr><tr><td><tt>metanav</tt></td><td>Order of the items to display in the <tt>metanav</tt> navigation bar, |
| | 231 | listed by IDs. See also <a class="missing wiki" href="/wiki/TracNavigation" rel="nofollow">TracNavigation?</a>.</td></tr><tr><td><tt>mysqldump_path</tt></td><td>Location of mysqldump for MySQL database backups</td></tr><tr><td><tt>never_obfuscate_mailto</tt></td><td>Never obfuscate <tt>mailto:</tt> links explicitly written in the wiki, |
| | 232 | even if <tt>show_email_addresses</tt> is false or the user has not the |
| | 233 | EMAIL_VIEW permission (<i>since 0.11.6</i>).</td></tr><tr><td><tt>permission_policies</tt></td><td>List of components implementing <tt>IPermissionPolicy</tt>, in the order in |
| | 234 | which they will be applied. These components manage fine-grained access |
| | 235 | control to Trac resources. |
| | 236 | Defaults to the <a class="missing wiki" href="/wiki/DefaultPermissionPolicy" rel="nofollow">DefaultPermissionPolicy?</a> (pre-0.11 behavior) and |
| | 237 | <a class="missing wiki" href="/wiki/LegacyAttachmentPolicy" rel="nofollow">LegacyAttachmentPolicy?</a> (map ATTACHMENT_* permissions to realm specific |
| | 238 | ones)</td></tr><tr><td><tt>permission_store</tt></td><td>Name of the component implementing <tt>IPermissionStore</tt>, which is used |
| | 239 | for managing user and group permissions.</td></tr><tr><td><tt>pg_dump_path</tt></td><td>Location of pg_dump for Postgres database backups</td></tr><tr><td><tt>repository_dir</tt></td><td>Path to local repository. This can also be a relative path |
| | 240 | (<i>since 0.11</i>).</td></tr><tr><td><tt>repository_type</tt></td><td>Repository connector type. (<i>since 0.10</i>)</td></tr><tr><td><tt>request_filters</tt></td><td>Ordered list of filters to apply to all requests |
| | 241 | (<i>since 0.10</i>).</td></tr><tr><td><tt>secure_cookies</tt></td><td>Restrict cookies to HTTPS connections. |
| | 242 | |
| | 243 | When true, set the <tt>secure</tt> flag on all cookies so that they are |
| | 244 | only sent to the server on HTTPS connections. Use this if your Trac |
| | 245 | instance is only accessible through HTTPS. (<i>since 0.11.2</i>)</td></tr><tr><td><tt>show_email_addresses</tt></td><td>Show email addresses instead of usernames. If false, we obfuscate |
| | 246 | email addresses (<i>since 0.11</i>).</td></tr><tr><td><tt>show_ip_addresses</tt></td><td>Show IP addresses for resource edits (e.g. wiki). |
| | 247 | (<i>since 0.11.3</i>).</td></tr><tr><td><tt>timeout</tt></td><td>Timeout value for database connection, in seconds. |
| | 248 | Use '0' to specify <i>no timeout</i>. <i>(Since 0.11)</i></td></tr><tr><td><tt>use_base_url_for_redirect</tt></td><td>Optionally use <tt>[trac] base_url</tt> for redirects. |
| | 249 | |
| | 250 | In some configurations, usually involving running Trac behind a HTTP |
| | 251 | proxy, Trac can't automatically reconstruct the URL that is used to |
| | 252 | access it. You may need to use this option to force Trac to use the |
| | 253 | <tt>base_url</tt> setting also for redirects. This introduces the obvious |
| | 254 | limitation that this environment will only be usable when accessible |
| | 255 | from that URL, as redirects are frequently used. <i>(since 0.10.5)</i></td></tr></tbody></table><h2 id="wiki-section">[wiki]</h2><table class="wiki"><tbody><tr><td><tt>ignore_missing_pages</tt></td><td>Enable/disable highlighting <a class="wiki" href="/wiki/CamelCase">CamelCase</a> links to missing pages |
| | 256 | (<i>since 0.9</i>).</td></tr><tr><td><tt>max_size</tt></td><td>Maximum allowed wiki page size in bytes. (<i>since 0.11.2</i>)</td></tr><tr><td><tt>render_unsafe_content</tt></td><td>Enable/disable the use of unsafe HTML tags such as <tt><script></tt> or |
| | 257 | <tt><embed></tt> with the HTML <a class="wiki" href="/wiki/WikiProcessors">WikiProcessor</a> |
| | 258 | (<i>since 0.10.4</i>). |
| | 259 | |
| | 260 | For public sites where anonymous users can edit the wiki it is |
| | 261 | recommended to leave this option disabled (which is the default).</td></tr><tr><td><tt>split_page_names</tt></td><td>Enable/disable splitting the <a class="wiki" href="/wiki/WikiPageNames">WikiPageNames</a> with space characters |
| | 262 | (<i>since 0.10</i>).</td></tr></tbody></table></div> |
| | 263 | }}} |
