Trac 配置文件
Trac 通过位于 <projectenv>/conf 目录中的 trac.ini 文件进行配置。trac.ini 配置文件及其父目录应可供 Web 服务器写入。
Trac 监视文件的时间戳，以便在时间戳更改时触发环境重新加载。大多数配置更改将立即生效，但对 [components] 或 [logging] 部分的更改需要重新启动 Web 服务器。在创建全局配置文件（如果以前没有）后，您可能还需要重新启动 Web 服务器。
全局配置
配置可以通过使用一个或多个全局配置文件在不同环境之间共享。全局配置中的选项将与环境特定的选项合并，本地选项会覆盖全局选项。全局配置文件指定如下：
[inherit] file = /path/to/global/trac.ini
可以使用逗号分隔列表指定多个文件。非绝对路径相对于环境的 conf 目录。
请注意，在创建新项目时，您也可以指定一个全局选项文件，方法是向 trac-admin 的 initenv 命令添加选项 --inherit=/path/to/global/trac.ini。如果您指定 --inherit 但仍打算在新环境中使用全局选项文件，则必须遍历新生成的 conf/trac.ini 文件并删除那些会覆盖全局文件中条目的条目。
[inherit] 部分还有三个选项，templates_dir 用于共享全局模板，htdocs_dir 用于共享全局 htdocs，以及 plugins_dir 用于共享插件。这些选项可以在共享配置文件中指定，事实上，如果您在那里指定另一个 [inherit] file，配置文件甚至可以链式引用。
请注意，在 TracEnvironment 的 templates/ 目录中找到的模板优先于在 [inherit] templates_dir 中找到的模板。反过来，后者优先于已安装的模板，因此请注意您在那里放置的内容。值得注意的是，如果您覆盖了默认模板，请在升级到新版本的 Trac 时刷新您的修改。执行 TracInterfaceCustomization 的首选方式是编写一个自定义插件，执行适当的 ITemplateStreamFilter 转换。
设置参考
这是可用配置选项及其默认设置的参考。
文档改进应在trac-dev 邮件列表上讨论，或在工单中描述。更好的是，提交针对代码中文档字符串的补丁。
[attachment]
max_size | 附件允许的最大文件大小（以字节为单位）。 | 262144 |
max_zip_size | 附件列表可下载为 | 2097152 |
render_unsafe_content | 附件应在浏览器中渲染，还是仅可下载。 几乎任何文件都可能被浏览器解释为 HTML，这允许恶意用户附加包含跨站脚本攻击的文件。 对于匿名用户可以创建附件的公共站点，建议禁用此选项。 | disabled |
[browser]
color_scale | 启用“年龄”列的颜色显示。 这使用与源代码注释相同的颜色比例：蓝色表示更旧，红色表示更新。 | enabled |
downloadable_paths | 可下载的仓库路径列表。 如果要禁用所有下载，请将此选项留空；否则，将其设置为逗号分隔的授权路径列表（这些路径是通配符模式，即“*”可用作通配符）。在多仓库环境中，如果路径不指向默认仓库，则必须使用仓库名称限定路径（例如 /reponame/trunk）。请注意，路径上执行简单的前缀匹配，因此别名不会自动解析。 | /trunk,/branches/*,/tags/* |
hide_properties | 逗号分隔的版本控制属性列表，用于在仓库浏览器中隐藏。 | svk:merge |
intermediate_color | 用于对应中间颜色的 (r,g,b) 颜色三元组，如果颜色比例使用两次线性插值（参见 | (无默认值) |
intermediate_point | 如果设置为 0 到 1 之间（不含）的值，这将是用于设置 | (无默认值) |
newest_color | 用于对应最新颜色的 (r,g,b) 颜色三元组，适用于“blame”或浏览器“年龄”列（如果启用了 | (255, 136, 136) |
oldest_color | 用于对应最旧颜色的 (r,g,b) 颜色三元组，适用于“blame”或浏览器“年龄”列（如果启用了 | (136, 136, 255) |
oneliner_properties | 逗号分隔的版本控制属性列表，用于在仓库浏览器中渲染为单行 Wiki 内容。 | trac:summary |
render_unsafe_content | 原始文件应在浏览器中渲染，还是仅可下载。 几乎任何文件都可能被浏览器解释为 HTML，这允许恶意用户创建包含跨站脚本攻击的文件。 对于任何人都可以签入文件的开放仓库，建议禁用此选项。 | disabled |
wiki_properties | 逗号分隔的版本控制属性列表，用于在仓库浏览器中渲染为 Wiki 内容。 | trac:description |
[changeset]
max_diff_bytes | 修改文件（其旧大小加上新大小）的最大总大小（以字节为单位），超过此大小，变更集视图将尝试以内联方式显示差异。 | 10000000 |
max_diff_files | 修改文件的最大数量，超过此数量，变更集视图将尝试以内联方式显示差异。 | 0 |
wiki_format_messages | 是否对变更集消息应用 Wiki 格式。 如果此选项被禁用，变更集消息将以预格式化文本渲染。 | enabled |
[components]
本节用于启用或禁用插件以及 Trac 本身提供的组件。要启用/禁用的组件通过选项名称指定。是否启用由选项值决定；将值设置为 enabled 或 on 将启用组件，任何其他值（通常是 disabled 或 off）将禁用组件。
选项名称可以是组件的完全限定名称，也可以是组件的模块/包前缀。前者启用/禁用特定组件，而后者启用/禁用指定包/模块中的任何组件。
考虑以下配置片段：
[components] trac.ticket.report.ReportModule = disabled acct_mgr.* = enabled
第一个选项告诉 Trac 禁用报告模块。第二个选项指示 Trac 启用 acct_mgr 包中的所有组件。请注意，模块/包匹配需要尾随的通配符。
要查看活动组件列表，请转到“关于 Trac”页面上的“插件”页面（需要 CONFIG_VIEW 权限）。
另请参阅：TracPlugins
[header_logo]
alt | 页眉 Logo 的替代文本。 | （请配置 trac.ini 中的 [header_logo] 部分） |
height | 页眉 Logo 图像的高度，以像素为单位。 | -1 |
link | 页眉 Logo 链接到的 URL。 | (无默认值) |
src | 用作页眉 Logo 的图像 URL。可以是绝对路径、服务器相对路径或相对路径。 如果是相对路径，则相对于 | site/your_project_logo.png |
width | 页眉 Logo 图像的宽度，以像素为单位。 | -1 |
[http-headers]
要添加到 HTTP 请求的头部。（自 1.2.3 版本起）
头部名称必须符合 RFC7230，并且不允许使用以下保留名称：content-type、content-length、location、etag、pragma、cache-control、expires。
[inherit]
htdocs_dir | 共享 htdocs 目录的路径。 该目录中的静态资源除了映射到 common 和 site 位置外，还映射到环境 URL 下的 /chrome/shared。 这在 site.html 中对于多个 Trac 环境的通用界面自定义很有用。 非绝对路径相对于环境的 | (无默认值) |
plugins_dir | 共享插件目录的路径。 除了环境 非绝对路径相对于环境的 | (无默认值) |
templates_dir | 共享模板目录的路径。 除了环境 非绝对路径相对于环境的 | (无默认值) |
[intertrac]
本节配置 InterTrac 前缀。本节中包含 . 的选项名称格式为 <name>.<attribute>。不包含 . 的选项名称定义别名。
.url 属性是强制性的，用于定位其他 Trac 实例。当其他 Trac 环境位于同一服务器上时，这可以是相对路径。
.title 属性用于在光标悬停在 InterTrac 链接上时生成工具提示。
示例配置
[intertrac] # -- Example of setting up an alias: t = trac # -- Link to an external Trac: genshi.title = Edgewall's Trac for Genshi genshi.url = https://genshi.edgewall.org
[interwiki]
[interwiki] 部分中的每个选项定义一个 InterWiki 前缀。选项名称定义前缀。选项值定义 URL，可选地后跟一个用空格与 URL 分隔的描述。也支持参数化 URL。
示例
[interwiki] MeatBall = http://www.usemod.com/cgi-bin/mb.pl? PEP = https://pythonlang.cn/peps/pep-$1.html Python Enhancement Proposal $1 tsvn = tsvn: Interact with TortoiseSvn
[logging]
log_file | 如果 | trac.log |
log_format | 自定义日志格式。 如果未设置，将使用以下格式：
除了 Python 日志库支持的常规键名外，还可以使用：
请注意使用 示例： | (无默认值) |
log_level | 日志的详细程度。 应为以下之一：( | INFO |
log_type | 要使用的日志工具。 应为以下之一：( | file |
[mainnav]
配置主导航栏，默认包含“Wiki”、“时间线”、“路线图”、“浏览源代码”、“查看工单”、“新建工单”、“搜索”和“管理”。
可以指定 label、href 和 order 属性。通过将导航项的值设置为 disabled 可以禁用条目。
以下示例将链接到 WikiStart 的名称更改为“主页”，将“查看工单”条目链接到特定报告，并禁用“搜索”条目。
[mainnav] wiki.label = Home tickets.href = /report/24 search = disabled
有关更多详细信息，请参阅 TracNavigation。
[metanav]
配置元导航条目，默认包括“登录”、“注销”、“偏好设置”、“帮助/指南”和“关于 Trac”。允许的属性与 [mainnav] 相同。此外，还支持一个特殊条目 - logout.redirect 是用户点击注销按钮后看到的页面。例如：
[metanav] logout.redirect = wiki/Logout
有关更多详细信息，请参阅 TracNavigation。
[milestone]
default_group_by | 在分组进度条中用于对工单进行分组的默认字段。（自 1.2 版本起） | component |
default_retarget_to | 关闭或删除里程碑时，工单默认重新定向到的里程碑。（自 1.1.2 版本起） | (无默认值) |
stats_provider | 实现 | DefaultTicketGroupStatsProvider |
[milestone-groups]
由于工单的工作流现在可配置，因此可能存在许多工单状态，简单地显示已关闭工单与其他所有工单可能并非在所有情况下都适用。本节允许轻松创建状态“组”，这些组将在里程碑进度条中以不同颜色显示。
请注意，组只能基于工单的“状态”，不能基于其他任何内容。特别是，无法根据“解决方案”区分不同的已关闭工单。
包含三个组（“已关闭”、“新建”和“活动”）的示例配置（默认只有已关闭和活动）：
# the 'closed' group correspond to the 'closed' tickets
closed = closed
# .order: sequence number in the progress bar
closed.order = 0
# .query_args: optional parameters for the corresponding
# query. In this example, the changes from the
# default are two additional columns ('created' and
# 'modified'), and sorting is done on 'created'.
closed.query_args = group=resolution,order=time,col=id,col=summary,col=owner,col=type,col=priority,col=component,col=severity,col=time,col=changetime
# .overall_completion: indicates groups that count for overall
# completion percentage
closed.overall_completion = true
new = new
new.order = 1
new.css_class = new
new.label = new
# Note: one catch-all group for other statuses is allowed
active = *
active.order = 2
# .css_class: CSS class for this interval
active.css_class = open
# .label: displayed label for this group
active.label = in progress
定义由逗号分隔的已接受状态列表组成。此外，“*”表示任何状态，可用于将所有剩余状态关联到一个包罗万象的组。
CSS 类可以是以下之一：new（黄色）、open（无颜色）或 closed（绿色）。可以使用自定义 CSS 规则轻松添加其他样式：例如，在 site/style.css 文件中添加 table.progress td.<class> { background: <color> }。
[mimeviewer]
max_preview_size | HTML 预览的最大文件大小。 | 262144 |
mime_map | 附加 MIME 类型和关键字映射列表。映射以逗号分隔，对于每种 MIME 类型，都有一个冒号（“:”）分隔的关联关键字或文件扩展名列表。 | text/x-dylan:dylan,text/x-idl:ice,text/x-ada:ads:adb |
mime_map_patterns | 与文件名模式关联的其他 MIME 类型列表。映射以逗号分隔，每个映射由 MIME 类型和用于匹配文件名的 Python 正则表达式组成，两者之间用冒号（“:”）分隔。（自 1.0 版本起） | text/plain:README(?!\.rst)|INSTALL(?!\.rst)|COPYING.* |
pygments_default_style | 用于 Pygments 语法高亮的默认样式。 | trac |
pygments_modes | Pygments 识别的其他 MIME 类型列表。 对于每种类型，必须指定一个元组 | (无默认值) |
tab_width | 文件预览中显示的制表符宽度。 | 8 |
treat_as_binary | 逗号分隔的 MIME 类型列表，应被视为二进制数据。 | application/octet-stream,application/pdf,application/postscript,application/msword,application/rtf |
[notification]
admit_domains | 逗号分隔的域列表，应被视为电子邮件地址的有效域（例如 localdomain）。 | (无默认值) |
ambiguous_char_width | 通知邮件表格中应使用的模糊字符宽度。 如果为 | single |
batch_subject_template | 类似于 | ${prefix} Batch modify: ${tickets_descr} |
default_format.email | 分发电子邮件通知的默认格式。 | text/plain |
email_address_resolvers | 逗号分隔的电子邮件解析器组件列表，按其调用顺序排列。如果已解析电子邮件地址，则不会调用其余解析器。 | SessionEmailResolver |
email_sender | 实现 此组件由通知系统用于发送电子邮件。Trac 目前提供 | SmtpEmailSender |
ignore_domains | 逗号分隔的域列表，不应被视为电子邮件地址的一部分（对于带有 Kerberos 域的用户名）。 | (无默认值) |
message_id_hash | 用于创建唯一 Message-ID 标头的哈希算法。（自 1.0.13 版本起） | md5 |
mime_encoding | 指定电子邮件的 MIME 编码方案。 支持的值有： | none |
sendmail_path | sendmail 可执行文件的路径。 sendmail 程序必须接受 | sendmail |
smtp_always_bcc | 逗号分隔的电子邮件地址列表，始终向其发送通知。地址不公开（密送：）。 | (无默认值) |
smtp_always_cc | 逗号分隔的电子邮件地址列表，始终向其发送通知。所有收件人都可以看到地址（抄送：）。 | (无默认值) |
smtp_default_domain | 默认主机/域，用于附加到未指定主机/域的地址。完全限定的地址不会被修改。默认域将附加到所有在用户设置中找不到电子邮件地址的用户名/登录名。 | (无默认值) |
smtp_enabled | 启用电子邮件通知。 | disabled |
smtp_from | 通知电子邮件中使用的发件人地址。
| trac@localhost |
smtp_from_author | 使用更改的作者作为通知电子邮件中的发件人（例如，新工单的报告者，评论的作者）。如果作者未设置电子邮件地址，则改用 | disabled |
smtp_from_name | 通知电子邮件中使用的发件人姓名。 | (无默认值) |
smtp_password | 用于与 SMTP 服务器进行身份验证的密码。 | (无默认值) |
smtp_port | 用于电子邮件通知的 SMTP 服务器端口。 | 25 |
smtp_replyto | 通知电子邮件中使用的回复地址。
| trac@localhost |
smtp_server | 用于电子邮件通知的 SMTP 服务器主机名。 | localhost |
smtp_subject_prefix | 通知电子邮件主题行前缀文本。 如果未定义此设置，则使用 | __default__ |
smtp_user | 用于与 SMTP 服务器进行身份验证的用户名。 | (无默认值) |
ticket_subject_template | 用于获取通知主题的 Jinja2 文本模板片段。 模板变量在 TracNotification 页面上进行了说明。 | ${prefix} #${ticket.id}: ${summary} |
use_public_cc | “收件人”和“抄送”字段中的地址对所有收件人可见。 如果此选项被禁用，则收件人将被放入密送列表。 | disabled |
use_short_addr | 允许不带主机/域的电子邮件地址（即仅用户名）。 SMTP 服务器应接受这些地址，并附加 FQDN 或使用本地投递。另请参阅 | disabled |
use_tls | 使用 SSL/TLS 通过 SMTP 发送通知。 | disabled |
[notification-subscriber]
通知订阅由插件控制。所有 INotificationSubscriber 组件负责。这些组件可能允许通过 trac.ini 文件中的本节进行配置。
有关更多详细信息，请参阅 TracNotification。
可用订阅者
| 订阅者 | 描述 |
|---|---|
AlwaysEmailSubscriber | |
CarbonCopySubscriber | 我被列在抄送字段中的工单被修改 |
NewTicketSubscriber | 任何工单被创建 |
TicketOwnerSubscriber | 我拥有的工单被创建或修改 |
TicketPreviousUpdatersSubscriber | 我之前更新过的工单被修改 |
TicketReporterSubscriber | 我报告的工单被修改 |
TicketUpdaterSubscriber | 我更新了一个工单 |
[osso]
auth_bypass_nick | 登录名是否应转换为昵称。 | disabled |
[project]
admin | 项目管理员的电子邮件地址。 | (无默认值) |
admin_trac_url | 报告此 Trac 中错误的 Trac 实例的基本 URL。 这可以是绝对或相对 URL，或者“.”表示引用此 Trac 实例。空值将禁用报告按钮。 | . |
descr | 项目的简短描述。 | 我的示例项目 |
footer | 页面页脚文本（右对齐）。 | 访问 Trac 开源项目：<br /><a href="https://trac.edgewall.org/">https://trac.edgewall.org/</a> |
icon | 项目图标的 URL。 | common/trac.ico |
name | 项目名称。 | 我的项目 |
url | 主项目网站的 URL，通常是 | (无默认值) |
[pygments-lexer]
配置 Pygments 词法分析器选项。
例如，要设置 PhpLexer 选项 startinline 和 funcnamehighlighting：
[pygments-lexer] php.startinline = True php.funcnamehighlighting = True
词法分析器名称派生自类名，并去掉了末尾的 Lexer。词法分析器“短名称”也可以代替词法分析器名称使用。
[query]
default_anonymous_query | 匿名用户的默认查询。查询可以是 查询语言语法，也可以是用于 | status!=closed&cc~=$USER |
default_query | 已认证用户的默认查询。查询可以是 查询语言语法，也可以是用于 | status!=closed&owner=$USER |
items_per_page | 默认情况下，工单查询中每页显示的工单数量。设置为 | 100 |
ticketlink_query | 链接工单字段值时使用的基本查询。查询是用于 | ?status=!closed |
[report]
items_per_page | 默认情况下，工单报告中每页显示的工单数量。设置为 | 100 |
items_per_page_rss | 报告的 RSS feed 中显示的工单数量。设置为 | 0 |
[repositories]
注册仓库的方法之一是填充 trac.ini 的 [repositories] 部分。
这特别适合设置别名，使用共享配置，或在环境创建时指定仓库。
有关本节格式的详细信息，请参阅 TracRepositoryAdmin，并查阅页面其他部分以获取其他仓库提供程序的信息。
[revisionlog]
default_log_limit | TracRevisionLog 中 limit 参数的默认值。 | 100 |
graph_colors | 逗号分隔的颜色列表，用于 TracRevisionLog 图形显示。（自 1.0 版本起） | #cc0,#0c0,#0cc,#00c,#c0c,#c00 |
[roadmap]
stats_provider | 实现 | DefaultTicketGroupStatsProvider |
[search]
default_disabled_filters | 指定在搜索页面上默认禁用哪些搜索过滤器。这也将限制快速搜索功能使用的过滤器。默认组件定义的过滤器名称为： | (无默认值) |
min_query_length | 执行搜索时允许的查询字符串的最小长度。 | 3 |
[sqlite]
extensions | SQLite 扩展的路径。路径可以是绝对路径，也可以是相对于 Trac 环境的路径。 | (无默认值) |
[svn]
authz_file | Subversion 授权 (authz) 文件的路径。要启用 authz 权限检查，必须将 | (无默认值) |
authz_module_name | 用于默认仓库的 | (无默认值) |
branches | 逗号分隔的路径列表，归类为分支。如果路径以“*”结尾，则将包含该路径下找到的所有目录条目。示例： | trunk,branches/* |
eol_style | 当 如果为 （自 1.0.2 版本起） | native |
tags | 逗号分隔的路径列表，归类为标签。 如果路径以“*”结尾，则将包含该路径下找到的所有目录条目。示例： | tags/* |
[svn:externals]
用于 Subversion 的 TracBrowser 可以解释文件夹的 svn:externals 属性。默认情况下，它只将 URL 转换为链接，因为 Trac 无法浏览远程仓库。
但是，如果您有另一个 Trac 实例（或另一个仓库浏览器，如 ViewVC）配置为浏览目标仓库，那么您可以指示 Trac 为哪个外部 URL 使用哪个其他仓库浏览器。此映射在 TracIni 的 [svn:externals] 部分中完成。
示例
[svn:externals] 1 = svn://server/repos1 http://trac/proj1/browser/$path?rev=$rev 2 = svn://server/repos2 http://trac/proj2/browser/$path?rev=$rev 3 = http://theirserver.org/svn/eng-soft http://ourserver/viewvc/svn/$path/?pathrev=25914 4 = svn://anotherserver.com/tools_repository http://ourserver/tracs/tools/browser/$path?rev=$rev
有了上述配置，svn://anotherserver.com/tools_repository/tags/1.1/tools 外部链接将被映射到 http://ourserver/tracs/tools/browser/tags/1.1/tools?rev=（如果外部链接额外指定了修订版本，rev 将设置为相应的修订版本号，更多详细信息请参阅 SVN Book on externals）。
请注意，上述部分中用作键的数字纯粹用作占位符，因为由于配置文件解析器的各种限制，URL 本身不能用作键。
最后，Subversion 1.5 中引入的相对 URL 尚不受支持。
[ticket]
allowed_empty_fields | 逗号分隔的 | milestone,version |
default_cc | 新创建工单的默认抄送列表。 | (无默认值) |
default_component | 新创建工单的默认组件。 | (无默认值) |
default_description | 新创建工单的默认描述。 | (无默认值) |
default_keywords | 新创建工单的默认关键字。 | (无默认值) |
default_milestone | 新创建工单的默认里程碑。 | (无默认值) |
default_owner | 新创建工单的默认所有者。当设置为 | < default > |
default_priority | 新创建工单的默认优先级。 | major |
default_resolution | 解决（关闭）工单的默认解决方案。 | fixed |
default_severity | 新创建工单的默认严重性。 | (无默认值) |
default_summary | 新创建工单的默认摘要（标题）。 | (无默认值) |
default_type | 新创建工单的默认类型。 | defect |
default_version | 新创建工单的默认版本。 | (无默认值) |
max_comment_size | 允许的最大评论大小（字符数）。 | 262144 |
max_description_size | 允许的最大描述大小（字符数）。 | 262144 |
max_summary_size | 允许的最大摘要大小（字符数）。（自 1.0.2 版本起） | 262144 |
preserve_newlines | Wiki 格式化程序是否应尊重 Wiki 文本中存在的新行。如果设置为“default”，则对于新环境等效于“yes”，但对于升级环境保留旧行为（即“no”）。 | default |
restrict_owner | 使工单的所有者字段使用下拉菜单。在激活此选项之前，请务必了解其性能影响。请参阅 作为下拉列表分配。 请注意，电子邮件地址在生成的下拉菜单中**不会**被混淆，因此如果电子邮件地址必须受到保护，则不应使用此选项。 | disabled |
workflow | 用于工单操作的工作流控制器有序列表。 | ConfigurableTicketWorkflow |
[ticket-custom]
在本节中，您可以为工单定义额外的字段。有关更多详细信息，请参阅 TracTicketsCustomFields。
[ticket-workflow]
工单的工作流由插件控制。默认情况下，只有一个 ConfigurableTicketWorkflow 组件负责。该组件允许通过 trac.ini 文件中的本节配置工作流。有关更多详细信息，请参阅 TracWorkflow。
[timeline]
abbreviated_messages | 是否截断 Wiki 格式的事件消息。 这仅影响默认渲染，并可由特定事件提供程序覆盖，请参阅其自己的文档。 | enabled |
changeset_collapse_events | 来自同一作者的连续变更集，如果消息完全相同，是否应显示为一个事件。该事件将链接到日志视图中的变更集范围。 | disabled |
changeset_long_messages | Wiki 格式的变更集消息是否应为多行。 如果未指定此选项或为 false，并且 | disabled |
changeset_show_files | 要显示的文件数量（ 这也可以是 | 0 |
default_daysback | 时间线中默认显示的天数，以天为单位。 | 30 |
max_daysback | 时间线中可显示的最大天数（-1 表示无限制）。 | 90 |
newticket_formatter | 呈现新工单描述时应使用哪种格式器风格（例如“html”或“oneliner”）。如果为“oneliner”，则应用 [timeline] abbreviated_messages 选项。 | oneliner |
ticket_show_component | 启用在时间线中显示工单的组件。（自 1.1.1 版本起） | disabled |
ticket_show_details | 启用在时间线中显示所有工单更改，而不仅仅是打开/关闭操作。 | enabled |
[trac]
anonymous_session_lifetime | 匿名会话的生命周期，以天为单位。 将此选项设置为 0 可禁用清除旧的匿名会话。（自 1.0.17 版本起） | 90 |
auto_preview_timeout | 自动 Wiki 预览触发更新之前的不活动超时时间，以秒为单位。此选项可以包含浮点值。设置越低，向服务器发出的请求越多。将此设置为 0 可禁用自动预览。 | 2.0 |
auto_reload | 修改后自动重新加载模板文件。 | disabled |
backup_dir | 数据库备份位置 | db |
base_url | Trac 部署的参考 URL。 这是在生成将在 Web 浏览上下文之外使用的文档时将使用的基本 URL，例如在通知电子邮件中插入指向 Trac 资源的 URL 时。 | (无默认值) |
database | 此项目的数据库连接字符串 | sqlite:db/trac.db |
debug_sql | 在 Trac 日志中以 DEBUG 级别显示 SQL 查询。 | disabled |
default_charset | 不确定时使用的字符集。 | utf-8 |
default_date_format | 日期格式。有效选项为 'iso8601' 用于选择 ISO 8601 格式，或者留空表示将根据浏览器的默认语言推断默认日期格式。（自 1.0 版本起） | (无默认值) |
default_dateinfo_format | 日期信息格式。有效选项为 'relative' 用于显示相对格式，'absolute' 用于显示绝对格式。（自 1.0 版本起） | relative |
default_handler | 处理基本 URL 请求的组件名称。 选项包括 设置了默认处理程序的会话偏好设置优先。 | WikiModule |
default_language | 如果未设置用户偏好，则使用的首选语言。 | (无默认值) |
default_timezone | 要使用的默认时区 | (无默认值) |
genshi_cache_size | 模板加载器在内存中缓存的模板的最大数量。如果您的站点使用大量模板并且您有足够的内存，您可能希望选择更高的值，或者如果内存不足，您可以减少它。 （已弃用，将在 Trac 1.5.1 中删除） | 128 |
htdocs_location | 用于服务 它可以留空，Trac 将简单地自行服务这些资源。 高级用户可以将其与 trac-admin ... deploy <deploydir> 一起使用，以允许 Web 服务器直接服务 Trac 的静态资源。但请注意，这仅适用于 | (无默认值) |
jquery_location | jQuery JavaScript 库（版本 1.12.4）的位置。 空值表示从 Trac 捆绑的副本中加载 jQuery。 或者，jQuery 可以从 CDN 加载，例如：https://code.jqueryjs.cn/jquery-1.12.4.min.js、http://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.12.4.min.js 或 https://ajax.googleapis.ac.cn/ajax/libs/jquery/1.12.4/jquery.min.js。 （自 1.0 版本起） | (无默认值) |
jquery_ui_location | jQuery UI JavaScript 库（版本 1.12.1）的位置。 空值表示从 Trac 捆绑的副本中加载 jQuery UI。 或者，jQuery UI 可以从 CDN 加载，例如：https://ajax.googleapis.ac.cn/ajax/libs/jqueryui/1.12.1/jquery-ui.min.js 或 http://ajax.aspnetcdn.com/ajax/jquery.ui/1.12.1/jquery-ui.min.js。 （自 1.0 版本起） | (无默认值) |
jquery_ui_theme_location | 与 jQuery UI JavaScript 库（版本 1.12.1）一起使用的主题位置。 空值表示从 Trac 捆绑的副本中加载自定义 Trac jQuery UI 主题。 或者，jQuery UI 主题可以从 CDN 加载，例如：https://ajax.googleapis.ac.cn/ajax/libs/jqueryui/1.12.1/themes/start/jquery-ui.css 或 http://ajax.aspnetcdn.com/ajax/jquery.ui/1.12.1/themes/start/jquery-ui.css。 （自 1.0 版本起） | (无默认值) |
mysqldump_path | 用于 MySQL 数据库备份的 mysqldump 位置 | mysqldump |
never_obfuscate_mailto | 即使 | disabled |
permission_policies | 实现 | DefaultWikiPolicy,DefaultTicketPolicy,DefaultPermissionPolicy,LegacyAttachmentPolicy |
permission_store | 实现 | DefaultPermissionStore |
request_filters | 应用于所有请求的过滤器有序列表。 | (无默认值) |
resizable_textareas | 使 | enabled |
secure_cookies | 将 Cookie 限制为 HTTPS 连接。 当为 true 时，在所有 Cookie 上设置 | disabled |
show_email_addresses | 显示电子邮件地址而不是用户名。如果为 false，则没有 EMAIL_VIEW 权限的用户的电子邮件地址将被混淆。 | disabled |
show_full_names | 显示全名而不是用户名。（自 1.2 版本起） | enabled |
timeout | 数据库连接的超时值，以秒为单位。使用“0”表示“无超时”。 | 20 |
use_base_url_for_redirect | 可选地使用 在某些配置中，通常涉及在 HTTP 代理后面运行 Trac，Trac 无法自动重构用于访问它的 URL。您可能需要使用此选项强制 Trac 也将 | disabled |
use_chunked_encoding | 如果启用，则在 HTTP/1.1 中以分块编码发送内容。否则，在渲染完整个内容后，发送带有 | enabled |
use_xsendfile | 当为 true 时，发送 | disabled |
wiki_toolbars | 在 Wiki | enabled |
xsendfile_header | 如果启用了 | X-Sendfile |
[versioncontrol]
allowed_repository_dir_prefixes | 在仓库管理面板中添加和编辑仓库时，仓库目录允许的前缀的逗号分隔列表。如果列表为空，则允许所有仓库目录。 | (无默认值) |
default_repository_type | 默认仓库连接器类型。 这用作在repositories部分中定义或使用“Repositories”管理面板定义的仓库的默认仓库类型。 | svn |
[wiki]
default_edit_area_height | Wiki 编辑页面上文本区域的默认高度。（自 1.1.5 版本起） | 20 |
ignore_missing_pages | 启用/禁用高亮显示指向缺失页面的 CamelCase 链接。 | disabled |
max_size | 允许的最大 Wiki 页面大小（字符数）。 | 262144 |
render_unsafe_content | 启用/禁用 HTML WikiProcessor 使用不安全的 HTML 标签，例如 对于匿名用户可以编辑 Wiki 的公共站点，建议禁用此选项。 | disabled |
safe_origins | 被认为是“安全跨源”的 URI 列表，它们将以 要使任何源安全，请在列表中指定“*”。 | data |
safe_schemes | 被认为是“安全”的 URI 方案列表，即使 | cvs,file,ftp,git,irc,http,https,news,sftp,smb,ssh,svn,svn+ssh |
split_page_names | 启用/禁用使用空格字符分割 WikiPageNames。 | disabled |
配置错误报告
错误报告页面有一个用于报告问题的“创建”按钮。报告问题的站点取决于 Trac 站点的配置和用户的权限。
如果用户不拥有 TRAC_ADMIN 权限，则用户被引导创建工单的站点由 [trac] admin_trac_url 设置决定：
- 如果为空，则不会有“创建”按钮。
- 如果设置为默认值（
.），则工单将在发生错误的站点上创建。 - 否则，工单将在
admin_trac_url指向的站点创建。
如果 [project] admin 不为空，管理员的电子邮件地址将在错误页面上渲染。
如果用户拥有 TRAC_ADMIN 权限，“创建”按钮将引导用户在 trac.edgewall.org 上报告问题。如果错误是在插件中生成的，并且插件作者已在插件安装数据中包含了项目 URL，则错误将报告给该项目 URL。拥有 TRAC_ADMIN 权限的用户还会在错误页面上看到回溯和系统信息。
另请参阅：TracAdmin、TracEnvironment
