The Trac Configuration File
內容索引
Trac is configured through the trac.ini file, located in the <projectenv>/conf directory. The trac.ini configuration file and its parent directory should be writable by the web server.
Trac monitors the timestamp of the file to trigger an environment reload when the timestamp changes. Most changes to the configuration will be reflected immediately, though changes to the [components] or [logging] sections will require restarting the web server. You may also need to restart the web server after creating a global configuration file when none was previously present.
Global Configuration
Configuration can be shared among environments using one or more global configuration files. Options in the global configuration will be merged with the environment-specific options, with local options overriding global options. The global configuration file is specified as follows:
[inherit] file = /path/to/global/trac.ini
Multiple files can be specified using a comma-separated list. Non-absolute paths are relative to the Environment conf directory.
Note that you can also specify a global option file when creating a new project, by adding the option --inherit=/path/to/global/trac.ini to trac-admin's initenv command. If you specify --inherit but nevertheless intend to use a global option file with your new environment, you will have to go through the newly generated conf/trac.ini file and delete the entries that will otherwise override those in the global file.
There are three more options in the [inherit] section, templates_dir for sharing global templates, htdocs_dir for sharing global htdocs and plugins_dir, for sharing plugins. Those options can be specified in the shared configuration file, and in fact, configuration files can even be chained if you specify another [inherit] file there.
Note that the templates found in the templates/ directory of the TracEnvironment have precedence over those found in [inherit] templates_dir. In turn, the latter have precedence over the installed templates, so be careful about what you put there. Notably, if you override a default template, refresh your modifications when you upgrade to a new version of Trac. The preferred way to perform TracInterfaceCustomization is to write a custom plugin doing an appropriate ITemplateStreamFilter transformation.
Reference for settings
This is a reference of available configuration options, and their default settings.
Documentation improvements should be discussed on the trac-dev mailing list or described in a ticket. Even better, submit a patch against the docstrings in the code.
[attachment]
max_size | 附件允許的最大檔案大小(以字節為單位)。 | 262144 |
max_zip_size | 以.zip格式下載時，最大允許的總大小(以字節為單位)。 將此設置為-1可禁用以.zip格式下載。(從 1.0) | 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 | 是否raw檔案應在瀏覽器中呈現，還是僅可下載。 瀏覽器幾乎可以將任何檔案解釋為HTML，這使惡意用戶可以建立包含跨站點腳本攻擊的檔案。 對於任何人都可以提交檔案的開放儲存庫，建議禁用此選項。 | disabled |
wiki_properties | 要在儲存庫瀏覽器中呈現為Wiki內容的版本控制屬性(逗號分隔列表)。 | trac:description |
[changeset]
max_diff_bytes | 在內崁差異變更檢視中將嘗試顯示的最大總和大小(舊大小加上新大小，單位是Byte)。 | 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 描述文字 | (please configure the [header_logo] section in trac.ini) |
height | 頁首 Logo 圖檔高度(單位: pixel) | -1 |
link | 頁首標誌連結到的網址。 | (無預設) |
src | 頁首標誌圖檔的網址。 它可以是絕對的，伺服器相對的或相對的。
如果是相對的，則相對於 | site/your_project_logo.png |
width | 頁首 Logo 圖檔寬度(單位: pixel) | -1 |
[http-headers]
標頭添加到HTTP請求。(從 1.2.3)
標頭名稱必須符合RFC7230規定，並且不允許使用以下保留名稱: content-type，content-length，location，etag，pragma，cache-control，expires。
[inherit]
htdocs_dir | 共享htdocs目錄的路徑。 除了公共位置和網站位置之外，此目錄中的靜態資源還映射到環境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。
範例:
[interwiki] MeatBall = http://www.usemod.com/cgi-bin/mb.pl? PEP = http://www.python.org/peps/pep-$1.html Python Enhancement Proposal $1 tsvn = tsvn: Interact with TortoiseSvn
[logging]
log_file |
如果 | trac.log |
log_format | 自定義日誌記錄格式。 如果未設置任何內容，則將使用以下內容:
除了Python logger library 支持的常規鍵名之外，還可以使用:
請注意，使用
範例:
| (無預設) |
log_level | 日誌中的層級設定。
應該是其中之一 ( | INFO |
log_type | 要使用的日誌工具。
應該是其中之一 ( | file |
[mainnav]
配置主導航欄，預設情況下包含Wiki，時間軸，開發藍圖, 瀏覽源碼，檢視待辦事項，新增待辦事項，搜尋 和 系統管理。
可以指定label，href 和order屬性。
可以將導航項目設置為disabled來禁用項目。
下面的範例將 WikiStart 的連結重命名為Home，將檢視待辦事項連結到特定的報表，並禁用搜索條目。
[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]
由於待辦事項的工作流程現在是可配置的，因此可以有許多待辦事項狀態， 僅顯示關閉的待辦事項vs.其他的待辦事項可能並不適合所有情況。 此區段可以輕鬆創建狀態的群組，這些狀態組將在里程碑進度欄中以不同的顏色顯示。
請注意，分組只能基於待辦事項狀態。 特別是，不可能根據處理結果來區分不同的已關閉待辦事項。
具有三個組的設定範例，分別為已關閉，新建的和活動的(預設僅具有已關閉和活動的):
# 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規則輕鬆添加其他樣式：
例如，table.progress td.<class> { background: <color> }到site/style.css檔案。
[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 | 在檔案預覽中顯示的tab寬度。 | 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 | 始終向其發送通知的電子郵件地址列表(逗號分隔列表)。 該地址不公開(Bcc:)。 | (無預設) |
smtp_always_cc | 始終向其發送通知的電子郵件地址列表(逗號分隔列表)。 所有收件人都可以看到該地址(Cc:)。 | (無預設) |
smtp_default_domain | 追加到未指定地址的預設主機名/網域。 完全合格的地址不會被修改。 預設網域將附加到在用戶設置中找不到其電子郵件地址的所有用戶名。 | (無預設) |
smtp_enabled | 啟用 email 通知 | disabled |
smtp_from | 在電子郵件通知中使用的發件人地址。
必須至少設置 | trac@localhost |
smtp_from_author |
在通知電子郵件中使用更改的作者作為發送者(例如: 新待辦事項的報告者，新留言的作者)。
如果作者未設置電子郵件地址，則改用 | disabled |
smtp_from_name | 在電子郵件通知中使用的發件人名稱。 | (無預設) |
smtp_password | 用於通過SMTP伺服器身份驗證的密碼。 | (無預設) |
smtp_port | EMail 通知用 SMTP 伺服器 Port | 25 |
smtp_replyto | 在通知電子郵件中使用的回覆地址。
必須至少設置 | trac@localhost |
smtp_server | EMail 通知用 SMTP 伺服器主機名稱 | localhost |
smtp_subject_prefix | 放在通知電子郵件的主題行之前的文字。
如果未定義設置，則將 | __default__ |
smtp_user | 用於通過SMTP伺服器身份驗證的用戶名。 | (無預設) |
ticket_subject_template | 用於獲取通知主題的Jinja2文字模板代碼段。 模板變量記錄在 TracNotification 頁面上。 | ${prefix} #${ticket.id}: ${summary} |
use_public_cc | To和Cc中的地址對所有收件人可見。 如果禁用此選項，則將收件人放入Bcc列表中。 | disabled |
use_short_addr | 允許沒有主機名/網域的電子郵件地址(即僅用戶名)。
SMTP伺服器應接受這些地址，並附加FQDN或使用本地傳遞。
另請參見 | disabled |
use_tls | 使用 SSL/TLS 寄送通知。 | disabled |
[notification-subscriber]
訂閱通知由外掛程式控制。
所有INotificationSubscriber組件都負責。
這些組件可能允許被配置透過trac.ini檔案的此區段。
更多資訊，請參見 TracNotification。
可用的訂閱者:
| 訂閱者 | 描述 |
|---|---|
AlwaysEmailSubscriber | |
CarbonCopySubscriber | 我加入副本的待辦事項被修改 |
NewTicketSubscriber | 任何待辦事項被建立 |
TicketOwnerSubscriber | 我負責的待辦事項被建立或修改 |
TicketPreviousUpdatersSubscriber | 我先前已更新的待辦事項被修改 |
TicketReporterSubscriber | 我報告的待辦事項被修改 |
TicketUpdaterSubscriber | 我更新一個待辦事項 |
[osso]
auth_bypass_nick | Whether login names should be converted to nick names. | disabled |
[project]
admin | 專案管理者 E-Mail 地址 | (無預設) |
admin_trac_url | Trac實例的基本URL，應在其中報告此Trac中的錯誤。 這可以是絕對或相對URL，也可以是'.'來引用此Trac實例。 空值將禁用報告按鈕。 | . |
descr | 專案簡短描述 | My example project |
footer | 頁面頁腳文字 (右對齊)。 | Visit the Trac open source project at<br /><a href="https://trac.edgewall.org/">https://trac.edgewall.org/</a> |
icon | 專案 icon 網址 | common/trac.ico |
name | 專案名稱 | My Project |
url |
主專案網站的URL，通常是 | (無預設) |
[pygments-lexer]
配置Pygments詞法分析器選項。
例如:要設置PHP詞法分析器選項startinline和funcnamehighlighting：{{{#!ini
[pygments-lexer]
php.startinline = True
php.funcnamehighlighting = True
}}}
詞法分析器名稱是從類別名稱衍生而來，擷取其中的最後部份。 短名稱也可以用來替代詞法分析器名稱。
[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摘要中顯示的待辦事項數目。
設置為 | 0 |
[repositories]
註冊儲存庫的方法之一是填充trac.ini的[repositories]區段。
這特別適合設置別名(使用共享配置)，或要在創建環境時就指定儲存庫。
有關此區段的詳細信息，請參見TracRepositoryAdmin，並在頁面上的其他地方查找有關其他儲存庫提供者的信息。
[revisionlog]
default_log_limit | TracRevisionLog 中預設每頁顯示的數目。 | 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 |
如果是 | native |
tags | 歸類為標籤的路徑(逗號分隔列表)。
如果路徑以'*'結尾，則包括在該路徑下找到的所有目錄。
範例: | tags/* |
[svn:externals]
Subversion的 TracBrowser 可以解釋文件夾的svn:externals屬性。
預設情況下，由於Trac無法瀏覽遠程儲存庫，因此只能將URL轉換為連結。
但是，如果您配置了另一個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 | 在DEBUG層級的Trac日誌中顯示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。 或者，可以從CDN加載jQuery，例如：http://code.jquery.com/jquery-1.12.4.min.js, http://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.12.4.min.js 或 https://ajax.googleapis.com/ajax/libs/jquery/1.12.4/jquery.min.js. (從 1.0) | (無預設) |
jquery_ui_location | jQuery UI JavaScript函式庫(版本 1.12.1)的位置。 空值時將從與Trac捆綁在一起的副本中加載jQuery UI。 或者，可以從CDN加載jQuery UI，例如：https://ajax.googleapis.com/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捆綁在一起的副本中加載jQuery UI主題。 或者，可以從CDN加載jQuery UI主題，例如：https://ajax.googleapis.com/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 |
永遠不要隱藏在Wiki中明確編寫的 | 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 |
在 | enabled |
xsendfile_header |
如果啟用 | X-Sendfile |
[versioncontrol]
allowed_repository_dir_prefixes | 在儲存庫管理面板中添加和編輯儲存庫時，允許的儲存庫目錄前綴(逗號分隔列表)。 如果列表為空，則允許所有儲存庫目錄。 | (無預設) |
default_repository_type | 預設儲存庫連接器類型。
| 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 |
Configure Error Reporting
The error reporting page has a Create button for reporting issues. The site to which issues are reported depends on the configuration of the Trac site and the user’s permissions.
If the user doesn’t possess TRAC_ADMIN, the site to which a user is directed to create a ticket is determined by the [trac] admin_trac_url setting:
- If empty, there will be no Create button.
- If set to the default value (
.), the ticket will be created on the site which the error occurred. - Otherwise the ticket will be created at the site pointed
to by
admin_trac_url.
If [project] admin is not empty, the administrator's email address will be rendered on the error page.
If the user possesses TRAC_ADMIN, the Create button will direct the user to report the issue on trac.edgewall.org. If the error was generated in a plugin, the error will be reported to the project URL provided that the plugin author has included the project URL in the plugin installation data. The user possessing TRAC_ADMIN also sees a traceback and system information on the error page.
See also: TracAdmin, TracEnvironment
