close
Warning:
Failed to sync with repository "ogBrowser-Git": (1366, "Incorrect string value: '\\xF0\\x9F\\x93\\xA6 I...' for column 'message' at row 1"); repository information may be out of date. Look in the Trac log for more information including mitigation strategies.
- Timestamp:
-
Mar 15, 2010, 9:46:23 AM (16 years ago)
- Author:
-
trac
- Comment:
-
--
Legend:
- Unmodified
- Added
- Removed
- Modified
-
|
v1
|
v2
|
|
| 4 | 4 | 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 | 5 | |
| | 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. |
| | 7 | |
| 6 | 8 | == Global Configuration == |
| 7 | 9 | |
| 8 | | In versions prior to 0.11, the global configuration was by default located in `$prefix/share/trac/conf/trac.ini` or sometimes /etc/trac/trac.ini depending on the distribution. If you're upgrading, you may want to specify that file to inherit from. |
| 9 | | Literally, when you're upgrading to 0.11, you have to add an `inherit`-section to your project's `trac.ini` file. Additionally you have to move your customized templates and common images from `$prefix/share/trac/...` to the new location. |
| | 10 | In versions prior to 0.11, the global configuration was by default located in `$prefix/share/trac/conf/trac.ini` or /etc/trac/trac.ini, depending on the distribution. If you're upgrading, you may want to specify that file to inherit from. Literally, when you're upgrading to 0.11, you have to add an `[inherit]` section to your project's `trac.ini` file. Additionally, you have to move your customized templates and common images from `$prefix/share/trac/...` to the new location. |
| 10 | 11 | |
| 11 | 12 | Global options will be merged with the environment-specific options, where local options override global options. The options file is specified as follows: |
| … |
… |
|
| 15 | 16 | }}} |
| 16 | 17 | |
| 17 | | Note that you can also specify a global option file when creating a new project, by adding the option |
| 18 | | `--inherit=/path/to/global/options` to [TracAdmin trac-admin]'s `initenv` command. |
| 19 | | If you would not do this but nevertheless intend to use a global option file with your new environment, |
| 20 | | you would have to go through the newly generated conf/trac.ini file and delete the entries that would |
| 21 | | otherwise override those set in the global file. |
| | 18 | Note that you can also specify a global option file when creating a new project, by adding the option `--inherit=/path/to/global/options` to [TracAdmin trac-admin]'s `initenv` command. If do not do this 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 set in the global file. |
| 22 | 19 | |
| 23 | 20 | |
| … |
… |
|
| 25 | 22 | |
| 26 | 23 | This is a brief reference of available configuration options. |
| | 24 | |
| | 25 | ''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.'' |
| 27 | 26 | |
| 28 | 27 | [[TracIni()]] |
| … |
… |
|
| 70 | 69 | {{{ |
| 71 | 70 | closed = closed |
| 72 | | closed.order = 0 # sequence number in the progress bar |
| 73 | | closed.query_args = group=resolution # optional extra param for the query |
| 74 | | closed.overall_completion = true # indicates groups that count for overall completion percentage |
| | 71 | # sequence number in the progress bar |
| | 72 | closed.order = 0 |
| | 73 | # optional extra param for the query (two additional columns: created and modified and sort on created) |
| | 74 | group=resolution,order=time,col=id,col=summary,col=owner,col=type,col=priority,col=component,col=severity,col=time,col=changetime |
| | 75 | # indicates groups that count for overall completion |
| | 76 | closed.overall_completion = truepercentage |
| 75 | 77 | |
| 76 | 78 | new = new |
| … |
… |
|
| 79 | 81 | new.label = new |
| 80 | 82 | |
| 81 | | active = * # one catch-all group is allowed |
| 82 | | active.order = 1 |
| 83 | | active.css_class = open # CSS class for this interval |
| 84 | | active.label = in progress # Displayed label for this group |
| | 83 | # one catch-all group is allowed |
| | 84 | active = * |
| | 85 | active.order = 2 |
| | 86 | # CSS class for this interval |
| | 87 | active.css_class = open |
| | 88 | # Displayed label for this group |
| | 89 | active.label = in progress |
| 85 | 90 | }}} |
| 86 | 91 | |
| … |
… |
|
| 97 | 102 | |
| 98 | 103 | The TracBrowser for Subversion can interpret the `svn:externals` property of folders out of the box. |
| 99 | | However, if those externals are ''not'' using the `http:` protocol, or if a link to a different repository browser (such another Trac or [http://www.viewvc.org/ ViewVC]) is desired, then Trac needs to be able to map an external prefix to this other URL. |
| | 104 | However, if those externals are ''not'' using the `http:` or `https:` protocol, or if a link to a different repository browser such as another Trac or [http://www.viewvc.org/ ViewVC] is desired, then Trac needs to be able to map an external prefix to this other URL. |
| 100 | 105 | |
| 101 | 106 | This mapping is done in the `[svn:externals]` section of the TracIni |
| … |
… |
|
| 107 | 112 | 2 = svn://server/repos2 http://trac/proj2/browser/$path?rev=$rev |
| 108 | 113 | 3 = http://theirserver.org/svn/eng-soft http://ourserver/viewvc/svn/$path/?pathrev=25914 |
| 109 | | 4 = svn://anotherserver.com/tools_repository http://ourserver/trac/support/browser/$path?rev=$rev |
| | 114 | 4 = svn://anotherserver.com/tools_repository http://ourserver/tracs/tools/browser/$path?rev=$rev |
| 110 | 115 | }}} |
| 111 | | With the above, the `svn://anotherserver.com/tools_repository/tags/1.1/tools` external will be mapped to `http://ourserver/trac/support/browser/tags/1.1/tools?rev=` (and `rev` will be set to the appropriate revision number if the external additionally specifies a revision, see the [http://svnbook.red-bean.com/en/1.4/svn.advanced.externals.html SVN Book on externals] for more details). |
| | 116 | With the above, the `svn://anotherserver.com/tools_repository/tags/1.1/tools` external will be mapped to `http://ourserver/tracs/tools/browser/tags/1.1/tools?rev=` (and `rev` will be set to the appropriate revision number if the external additionally specifies a revision, see the [http://svnbook.red-bean.com/en/1.4/svn.advanced.externals.html SVN Book on externals] for more details). |
| 112 | 117 | |
| 113 | 118 | Note that the number used as a key in the above section is purely used as a place holder, as the URLs themselves can't be used as a key due to various limitations in the configuration file parser. |
| 114 | 119 | |
| | 120 | Finally, the relative URLs introduced in [http://subversion.tigris.org/svn_1.5_releasenotes.html#externals Subversion 1.5] are not yet supported. |
| | 121 | |
| 115 | 122 | ---- |
| 116 | 123 | See also: TracGuide, TracAdmin, TracEnvironment |
