Changes between Version 6 and Version 7 of TracIni


Ignore:
Timestamp:
May 30, 2008 2:26:53 PM (8 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracIni

    v6 v7  
    11= The Trac Configuration File =
     2
    23[[TracGuideToc]]
    3 
    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.
    54
    65== Global Configuration ==
    76
    8 In previous versions, 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.
     7In 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.
    98
    109Global options will be merged with the environment-specific options, where local options override global options. The options file is specified as follows:
     
    1413}}}
    1514
     15Note that you can also specify a global option file when creating a new project,  by adding the option
     16`--inherit=/path/to/global/options` to [TracAdmin trac-admin]'s `initenv` command.
     17If you would not do this but nevertheless intend to use a global option file with your new environment,
     18you would have to go through the newly generated conf/trac.ini file and delete the entries that would
     19otherwise override those set in the global file.
     20
     21
    1622== Reference ==
    1723
    1824This is a brief reference of available configuration options.
    1925
    20 [[TracIni]]
     26[[TracIni()]]
     27
    2128
    2229== [components] == #components-section
     
    6875active.order = 1
    6976active.css_class = open              # CSS class for this interval
     77active.label = in progress           # Displayed label for this group
    7078}}}
    7179
     
    8997{{{
    9098[svn:externals]
    91 http://theirserver.org/svn/eng-soft       http://ourserver/viewvc/svn/$path/?pathrev=25914
    92 svn://anotherserver.com/tools_repository  http://ourserver/trac/support/browser/$path?rev=$rev
     991 = svn://server/repos1 http://trac/proj1/browser/$path?rev=$rev
     1002 = svn://server/repos2 http://trac/proj2/browser/$path?rev=$rev
     1013 = http://theirserver.org/svn/eng-soft       http://ourserver/viewvc/svn/$path/?pathrev=25914
     1024 = svn://anotherserver.com/tools_repository  http://ourserver/trac/support/browser/$path?rev=$rev
    93103}}}
    94104With 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).
    95105
     106Note 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.
    96107
    97108----