Changes between Version 1 and Version 2 of TracEnvironment
- Timestamp:
- Feb 24, 2010 5:37:18 PM (11 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracEnvironment
v1 v2 10 10 }}} 11 11 12 [wiki:TracAdmin trac-admin] will ask you for the name of the project, the 13 database connection string (explained below), and the type and path to 14 your source code repository. 12 [wiki:TracAdmin trac-admin] will ask you for the name of the project and the 13 database connection string (explained below). 15 14 16 15 ''Note: The web server user will require file system write permission to … … 20 19 as you're not using the BDB file system. Also, it seems that project names 21 20 with spaces can be problematic for authentication (see [trac:#7163]).'' 21 22 ''Note: "initenv" when using svn repository does not imply that trac-admin will perform "svnadmin create" for the specified repository path. You need to perform the "svnadmin create" prior to trac-admin initenv if you're creating a new svn repository altogether with a new trac environment, otherwise you will see a message "Warning: couldn't index the repository" when initializing the environment.'' 22 23 23 24 == Database Connection Strings == … … 95 96 == Source Code Repository == 96 97 97 You'll first have to provide the ''type'' of your repository (e.g. `svn` for Subversion, 98 which is the default), then the ''path'' where the repository is located. 98 Since version 0.12, one Trac environment can be tied to more than one repository. There are many different ways to add repositories to an environment, see TracRepositoryAdmin. This page also details the various attributes that can be set on a repository (like `type`, `url`, `description`). 99 99 100 If you don't want to use Trac with a source code repository, simply leave the ''path'' empty 101 (the ''type'' information doesn't matter, then). 100 If you don't want to use Trac with any source code repository, at creation time simply leave the ''path'' empty 101 (the ''type'' information doesn't matter in this case). Then you also need to disable the `trac.versioncontrol.*` components: 102 {{{ 103 [components] 104 trac.versioncontrol.* = disabled 105 }}} 102 106 103 107 For some systems, it is possible to specify not only the path to the repository, … … 106 110 Trac supports this; for other types, check the corresponding plugin's documentation. 107 111 108 Example of a configuration for a Subversion repository :112 Example of a configuration for a Subversion repository used as the default repository: 109 113 {{{ 110 114 [trac] … … 131 135 * `db` 132 136 * `trac.db` - The SQLite database (if you're using SQLite). 133 * `htdocs` - directory containing web resources, which can be referenced in Genshi templates. '''''( 0.11 only)'''''137 * `htdocs` - directory containing web resources, which can be referenced in Genshi templates. '''''(since 0.11)''''' 134 138 * `log` - default directory for log files, if logging is turned on and a relative path is given. 135 * `plugins` - Environment-specific [wiki:TracPlugins plugins] (Python eggs, since [milestone:0.10]) 136 * `templates` - Custom ClearSilver environment-specific templates. '''''(0.10 only)''''' 137 * `site_css.cs` - Custom CSS rules. 138 * `site_footer.cs` - Custom page footer. 139 * `site_header.cs` - Custom page header. 140 * `templates` - Custom Genshi environment-specific templates. '''''(0.11 only)''''' 139 * `plugins` - Environment-specific [wiki:TracPlugins plugins] (Python eggs or single file plugins, since [trac:milestone:0.10 0.10]) 140 * `templates` - Custom Genshi environment-specific templates. '''''(since 0.11)''''' 141 141 * `site.html` - method to customize header, footer, and style, described in TracInterfaceCustomization#SiteAppearance 142 * `wiki-macros` - Environment-specific [WikiMacros Wiki macros]. '''''(0.10 only)'''''143 142 144 '''Note: don't confuse a Trac environment directory with the source code repository directory. 145 It happens that the above structure is loosely modelled after the Subversion repository directory 146 structure, but they are not and ''must not'' be located at the same place.''' 143 '''Caveat:''' ''don't confuse a Trac environment directory with the source code repository directory.'' 144 145 This is a common beginners' mistake. 146 It happens that the structure for a Trac environment is loosely modelled after the Subversion repository directory 147 structure, but those are two disjoint entities and they are not and ''must not'' be located at the same place. 147 148 148 149 ---- 149 150 See also: TracAdmin, TracBackup, TracIni, TracGuide 151