Changes between Version 2 and Version 3 of TracIni
- Timestamp:
- 2012-07-24T19:03:35Z (12 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracIni
v2 v3 1 1 = The Trac Configuration File = 2 3 ''[Note To Editors] Please discuss documentation changes in the [#Discussion] section. Even better, send us [TracDev/SubmittingPatches documentation patches] against the ''code'' (i.e. where the configuration entries are documented), either on Trac-dev or on new tickets. '' 4 2 5 [[TracGuideToc]] 6 [[PageOutline]] 3 7 4 8 Trac configuration is done by editing the '''`trac.ini`''' config file, located in `<projectenv>/conf/trac.ini`. Changes to the configuration are usually 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. 5 9 6 The `trac.ini` configuration file should be writable by the web server, as Trac currently relies on the possibility to trigger a complete environment reload to flush its caches.10 The `trac.ini` configuration file and its parent directory should be writable by the web server, as Trac currently relies on the possibility to trigger a complete environment reload to flush its caches. 7 11 8 12 == Global Configuration == … … 21 25 There are two more entries in the [[#inherit-section| [inherit] ]] section, `templates_dir` for sharing global templates and `plugins_dir`, for sharing plugins. Those entries can themselves be specified in the shared configuration file, and in fact, configuration files can even be chained if you specify another `[inherit] file` there. 22 26 27 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 be sure to refresh your modifications when you upgrade to a new version of Trac (the preferred way to perform TracInterfaceCustomization being still to write a custom plugin doing an appropriate `ITemplateStreamFilter` transformation). 28 23 29 == Reference for settings 24 30 25 This is a brief reference of available configuration options .31 This is a brief reference of available configuration options, and their default settings. 26 32 33 ''Note that the [bitten], [spam-filter] and [vote] sections below are added by plugins enabled on this Trac, and therefore won't be part of a default installation.'' 34 35 {{{ 36 #!comment 37 Suggest your documentation fixes in the Discussion section at 38 the bottom of the page, or better send us patches against 39 the corresponding docstrings you'll find in the code! 40 41 Please don't waste your time by editing the HTML code below, changes won't be picked up. 42 }}} 27 43 [[TracIni]] 28 44 … … 48 64 See also: TracPlugins 49 65 66 === [extra-permissions] === #extra-permissions-section 67 ''(since 0.12)'' 68 69 Custom additional permissions can be defined in this section when [wiki:ExtraPermissionsProvider] is enabled. 70 50 71 === [milestone-groups] === #milestone-groups-section 51 72 ''(since 0.11)'' … … 63 84 # optional extra param for the query (two additional columns: created and modified and sort on created) 64 85 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 65 # indicates groups that count for overall completion 66 closed.overall_completion = true percentage86 # indicates groups that count for overall completion percentage 87 closed.overall_completion = true 67 88 68 89 new = new … … 134 155 See TracWorkflow for more details. 135 156 136 137 157 ---- 138 158 See also: TracGuide, TracAdmin, TracEnvironment
