16 | | [[TracIni]] |
| 16 | {{{ |
| 17 | #!html |
| 18 | <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 for ticket and wiki attachments.</td></tr><tr><td><tt>render_unsafe_content</tt></td><td>Whether attachments should be rendered in the browser, or |
| 19 | only made downloadable. |
| 20 | |
| 21 | Pretty much any file may be interpreted as HTML by the browser, |
| 22 | which allows a malicious user to attach a file containing cross-site |
| 23 | scripting attacks. |
| 24 | |
| 25 | For public sites where anonymous users can create attachments it is |
| 26 | 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>render_unsafe_content</tt></td><td>Whether attachments should be rendered in the browser, or |
| 27 | only made downloadable. |
| 28 | |
| 29 | Pretty much any file may be interpreted as HTML by the browser, |
| 30 | which allows a malicious user to attach a file containing cross-site |
| 31 | scripting attacks. |
| 32 | |
| 33 | For public sites where anonymous users can create attachments it is |
| 34 | recommended to leave this option disabled (which is the default).</td></tr><tr><td><tt>hide_properties</tt></td><td>List of subversion properties to hide from the repository browser |
| 35 | (<i>since 0.9</i>)</td></tr><tr><td><tt>downloadable_paths</tt></td><td>List of repository paths that can be downloaded. |
| 36 | |
| 37 | Leave the option empty if you want to disable all downloads, otherwise |
| 38 | set it to a comma-separated list of authorized paths (those paths are |
| 39 | glob patterns, i.e. "*" can be used as a wild card) |
| 40 | (<i>since 0.10</i>)</td></tr></tbody></table><h2 id="changeset-section">[changeset]</h2><table class="wiki"><tbody><tr><td><tt>wiki_format_messages</tt></td><td>Whether wiki formatting should be applied to changeset messages. |
| 41 | |
| 42 | If this option is disabled, changeset messages will be rendered as |
| 43 | pre-formatted text.</td></tr><tr><td><tt>max_diff_files</tt></td><td>Maximum number of modified files for which the changeset view will |
| 44 | attempt to show the diffs inlined (<i>since 0.10</i>).</td></tr><tr><td><tt>max_diff_bytes</tt></td><td>Maximum total size in bytes of the modified files (their old size |
| 45 | plus their new size) for which the changeset view will attempt to show |
| 46 | the diffs inlined (<i>since 0.10</i>).</td></tr></tbody></table><h2 id="header_logo-section">[header_logo]</h2><table class="wiki"><tbody><tr><td><tt>width</tt></td><td>Width of the header logo image in pixels.</td></tr><tr><td><tt>height</tt></td><td>Height of the header logo image in pixels.</td></tr><tr><td><tt>alt</tt></td><td>Alternative text for the 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>link</tt></td><td>URL to link to from header logo.</td></tr></tbody></table><h2 id="logging-section">[logging]</h2><table class="wiki"><tbody><tr><td><tt>log_level</tt></td><td>Level of verbosity in log. |
| 47 | |
| 48 | 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_format</tt></td><td>Custom logging format. |
| 49 | |
| 50 | If nothing is set, the following will be used: |
| 51 | |
| 52 | Trac[$(module)s] $(levelname)s: $(message)s |
| 53 | |
| 54 | In addition to regular key names supported by the Python logger library |
| 55 | library (see <a class="ext-link" href="http://docs.python.org/lib/node422.html"><span class="icon">http://docs.python.org/lib/node422.html</span></a>), one could use: |
| 56 | - $(path)s the path for the current environment |
| 57 | - $(basename)s the last path component of the current environment |
| 58 | - $(project)s the project name |
| 59 | |
| 60 | Note the usage of <tt>$(...)s</tt> instead of <tt>%(...)s</tt> as the latter form |
| 61 | would be interpreted by the <a class="missing wiki" href="/wiki/ConfigParser" rel="nofollow">ConfigParser?</a> itself. |
| 62 | |
| 63 | Example: |
| 64 | ($(thread)d) Trac[$(basename)s:$(module)s] $(levelname)s: $(message)s |
| 65 | |
| 66 | (since 0.11)</td></tr><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_type</tt></td><td>Logging facility to use. |
| 67 | |
| 68 | 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="mimeviewer-section">[mimeviewer]</h2><table class="wiki"><tbody><tr><td><tt>php_path</tt></td><td>Path to the PHP executable (<i>since 0.9</i>).</td></tr><tr><td><tt>silvercity_modes</tt></td><td>List of additional MIME types known by <a class="wiki" href="/wiki/SilverCity">SilverCity</a>. |
| 69 | For each, a tuple <tt>mimetype:mode:quality</tt> has to be |
| 70 | specified, where <tt>mimetype</tt> is the MIME type, |
| 71 | <tt>mode</tt> is the corresponding <a class="wiki" href="/wiki/SilverCity">SilverCity</a> mode to be used |
| 72 | for the conversion and <tt>quality</tt> is the quality ratio |
| 73 | associated to this conversion. |
| 74 | That can also be used to override the default |
| 75 | quality ratio used by the <a class="wiki" href="/wiki/SilverCity">SilverCity</a> render, which is 3 |
| 76 | (<i>since 0.10</i>).</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>max_preview_size</tt></td><td>Maximum file size for HTML preview. (<i>since 0.9</i>).</td></tr><tr><td><tt>enscript_modes</tt></td><td>List of additional MIME types known by Enscript. |
| 77 | For each, a tuple <tt>mimetype:mode:quality</tt> has to be |
| 78 | specified, where <tt>mimetype</tt> is the MIME type, |
| 79 | <tt>mode</tt> is the corresponding Enscript mode to be used |
| 80 | for the conversion and <tt>quality</tt> is the quality ratio |
| 81 | associated to this conversion. |
| 82 | That can also be used to override the default |
| 83 | quality ratio used by the Enscript render, which is 2 |
| 84 | (<i>since 0.10</i>).</td></tr><tr><td><tt>mime_map</tt></td><td>List of additional MIME types and keyword mappings. |
| 85 | Mappings are comma-separated, and for each MIME type, |
| 86 | there's a colon (":") separated list of associated keywords |
| 87 | or file extensions. (<i>since 0.10</i>).</td></tr><tr><td><tt>pygments_modes</tt></td><td>List of additional MIME types known by Pygments. |
| 88 | |
| 89 | For each, a tuple <tt>mimetype:mode:quality</tt> has to be |
| 90 | specified, where <tt>mimetype</tt> is the MIME type, |
| 91 | <tt>mode</tt> is the corresponding Pygments mode to be used |
| 92 | for the conversion and <tt>quality</tt> is the quality ratio |
| 93 | associated to this conversion. That can also be used |
| 94 | to override the default quality ratio used by the |
| 95 | Pygments render.</td></tr><tr><td><tt>enscript_path</tt></td><td>Path to the Enscript executable.</td></tr><tr><td><tt>pygments_default_style</tt></td><td>The default style to use for Pygments syntax highlighting.</td></tr></tbody></table><h2 id="notification-section">[notification]</h2><table class="wiki"><tbody><tr><td><tt>smtp_always_bcc</tt></td><td>Email address(es) to always send notifications to, |
| 96 | addresses do not appear publicly (Bcc:). (<i>since 0.10</i>).</td></tr><tr><td><tt>always_notify_updater</tt></td><td>Always send notifications to the person who causes the ticket |
| 97 | property change.</td></tr><tr><td><tt>smtp_user</tt></td><td>Username for SMTP server. (<i>since 0.9</i>).</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>smtp_subject_prefix</tt></td><td>Text to prepend to subject line of notification emails. |
| 98 | |
| 99 | If the setting is not defined, then the [$project_name] prefix. |
| 100 | If no prefix is desired, then specifying an empty option |
| 101 | will disable it.(<i>since 0.10.1</i>).</td></tr><tr><td><tt>smtp_replyto</tt></td><td>Reply-To address to use in notification emails.</td></tr><tr><td><tt>smtp_port</tt></td><td>SMTP server port to use for 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_default_domain</tt></td><td>Default host/domain to append to address that do not specify one</td></tr><tr><td><tt>use_tls</tt></td><td>Use SSL/TLS to send notifications (<i>since 0.10</i>).</td></tr><tr><td><tt>always_notify_reporter</tt></td><td>Always send notifications to any address in the <i>reporter</i> |
| 102 | |
| 103 | field.</td></tr><tr><td><tt>smtp_enabled</tt></td><td>Enable SMTP (email) notification.</td></tr><tr><td><tt>mime_encoding</tt></td><td>Specifies the MIME encoding scheme for emails. |
| 104 | |
| 105 | Valid options are 'base64' for Base64 encoding, 'qp' for |
| 106 | Quoted-Printable, and 'none' for no encoding. Note that the no encoding |
| 107 | means that non-ASCII characters in text are going to cause problems |
| 108 | with notifications (<i>since 0.10</i>).</td></tr><tr><td><tt>smtp_always_cc</tt></td><td>Email address(es) to always send notifications to, |
| 109 | addresses can be see by all recipients (Cc:).</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_server</tt></td><td>SMTP server hostname to use for email notifications.</td></tr><tr><td><tt>use_public_cc</tt></td><td>Recipients can see email addresses of other CC'ed recipients. |
| 110 | |
| 111 | If this option is disabled (the default), recipients are put on BCC |
| 112 | (<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) |
| 113 | |
| 114 | The SMTP server should accept those addresses, and either append |
| 115 | a FQDN or use local delivery (<i>since 0.10</i>).</td></tr></tbody></table><h2 id="project-section">[project]</h2><table class="wiki"><tbody><tr><td><tt>url</tt></td><td>URL of the main project web site.</td></tr><tr><td><tt>name</tt></td><td>Name of the project.</td></tr><tr><td><tt>icon</tt></td><td>URL of the icon of the project.</td></tr><tr><td><tt>footer</tt></td><td>Page footer text (right-aligned).</td></tr><tr><td><tt>descr</tt></td><td>Short description of the project.</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="ticket-section">[ticket]</h2><table class="wiki"><tbody><tr><td><tt>default_version</tt></td><td>Default version 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>restrict_owner</tt></td><td>Make the owner field of tickets use a drop-down menu. See |
| 116 | <a class="wiki" href="/wiki/TracTickets#Assign-toasDrop-DownList">Assign-to as Drop-Down List</a> |
| 117 | |
| 118 | (<i>since 0.9</i>).</td></tr><tr><td><tt>default_priority</tt></td><td>Default priority 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_component</tt></td><td>Default component for newly created tickets</td></tr></tbody></table><h2 id="timeline-section">[timeline]</h2><table class="wiki"><tbody><tr><td><tt>changeset_long_messages</tt></td><td>Whether wiki-formatted changeset messages should be multiline or not. |
| 119 | |
| 120 | If this option is not specified or is false and <tt>wiki_format_messages</tt> |
| 121 | is set to true, changeset messages will be single line only, losing |
| 122 | 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).</td></tr><tr><td><tt>default_daysback</tt></td><td>Default number of days displayed in the Timeline, in days. |
| 123 | (<i>since 0.9.</i>)</td></tr><tr><td><tt>ticket_show_details</tt></td><td>Enable the display of all ticket changes in the timeline |
| 124 | (<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 |
| 125 | <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">authorization (authz) file</span></a></td></tr><tr><td><tt>check_auth_ip</tt></td><td>Whether the IP address of the user should be checked for |
| 126 | authentication (<i>since 0.9</i>).</td></tr><tr><td><tt>database</tt></td><td>Database connection |
| 127 | <a class="wiki" href="/wiki/TracEnvironment#DatabaseConnectionStrings">string</a> for this |
| 128 | project</td></tr><tr><td><tt>ignore_auth_case</tt></td><td>Whether case should be ignored for login names (<i>since 0.9</i>).</td></tr><tr><td><tt>metanav</tt></td><td>List of items IDs to display in the navigation bar <tt>metanav</tt>.</td></tr><tr><td><tt>base_url</tt></td><td>Base URL of the Trac deployment. |
| 129 | |
| 130 | In most configurations, Trac will automatically reconstruct the URL |
| 131 | that is used to access it automatically. However, in more complex |
| 132 | setups, usually involving running Trac behind a HTTP proxy, you may |
| 133 | need to use this option to force Trac to use the correct URL.</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. |
| 134 | |
| 135 | Options include <tt>TimelineModule</tt>, <tt>RoadmapModule</tt>, <tt>BrowserModule</tt>, |
| 136 | <tt>QueryModule</tt>, <tt>ReportModule</tt> and <tt>NewticketModule</tt> (<i>since 0.9</i>).</td></tr><tr><td><tt>htdocs_location</tt></td><td>Base URL of the core static resources.</td></tr><tr><td><tt>permission_store</tt></td><td>Name of the component implementing <tt>IPermissionStore</tt>, which is used |
| 137 | for managing user and group permissions.</td></tr><tr><td><tt>templates_dir</tt></td><td>Path to the ClearSilver templates.</td></tr><tr><td><tt>repository_dir</tt></td><td>Path to local repository</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 |
| 138 | (<i>since 0.10</i>).</td></tr><tr><td><tt>timeout</tt></td><td>Timeout value for database connection, in seconds. |
| 139 | Use '0' to specify <i>no timeout</i>. <i>(Since 0.11)</i></td></tr><tr><td><tt>mainnav</tt></td><td>List of item IDs to display in the navigation bar <tt>mainnav</tt>.</td></tr><tr><td><tt>authz_module_name</tt></td><td>The module prefix used in the authz_file.</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 |
| 140 | (<i>since 0.9</i>).</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 |
| 141 | (<i>since 0.10</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 |
| 142 | <tt><embed></tt> with the HTML <a class="wiki" href="/wiki/WikiProcessors">WikiProcessor</a> |
| 143 | |
| 144 | (<i>since 0.10.4</i>). |
| 145 | |
| 146 | For public sites where anonymous users can edit the wiki it is |
| 147 | recommended to leave this option disabled (which is the default).</td></tr></tbody></table></div> |
| 148 | }}} |