Changes between Version 1 and Version 2 of TracEnvironment

Timestamp:

Sep 10, 2012, 7:25:57 PM (12 years ago)

Author:

trac

Comment:

--

TracEnvironment

@@ -5 +5 @@
 == Creating an Environment ==
 
-A new Trac environment is created using  [wiki:TracAdmin trac-admin]:
+A new Trac environment is created using  [TracAdmin#initenv trac-admin's initenv]:
 {{{
 $ trac-admin /path/to/myproject initenv
 }}}
 
-[wiki:TracAdmin trac-admin] will ask you for the name of the project and the
+`trac-admin` will ask you for the name of the project and the
 database connection string (explained below).
 
-''Note: The user under which the web server runs will require file system write permission to 
-the environment directory and all the files inside. Please remember to set
-the appropriate permissions. The same applies to the source code repository, 
-although the user under which Trac runs will only require write access to a Subversion repository created with the BDB file system
-; for other repository types, check the corresponding plugin's documentation. 
-Also, it seems that project names with spaces can be problematic for authentication (see [trac:#7163]).''
+=== Some Useful Tips
+ - The user under which the web server runs will require file system write permission to 
+ the environment directory and all the files inside. Please remember to set
+ the appropriate permissions. The same applies to the source code repository, 
+ although the user under which Trac runs will only require write access to a Subversion repository created with the BDB file system; for other repository types, check the corresponding plugin's documentation. 
+ 
+ - `initenv`, when using an 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.
 
-''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.''
+ - Non-ascii environment paths are not supported
+ 
+ - Also, it seems that project names with spaces can be problematic for authentication (see [trac:#7163]).
+
+ - TracPlugins located in a [TracIni#inherit-section shared plugins folder] that is defined in an [TracIni#GlobalConfiguration inherited configuration] are currently not loaded during creation, and hence, if they need to create extra tables for example, you'll need to [TracUpgrade#UpgradetheTracEnvironment upgrade the environment] before being able to use it.
 
 == Database Connection Strings ==
@@ -136 +141 @@
  * `db`
    * `trac.db` - The SQLite database (if you're using SQLite).
- * `htdocs` - directory containing web resources, which can be referenced in Genshi templates. '''''(since 0.11)'''''
+ * `htdocs` - directory containing web resources, which can be referenced in Genshi templates using `/htdocs/site/...` URLs. ''(since 0.11)''
  * `log` - default directory for log files, if logging is turned on and a relative path is given.
  * `plugins` - Environment-specific [wiki:TracPlugins plugins] (Python eggs or single file plugins, since [trac:milestone:0.10 0.10])
- * `templates` - Custom Genshi environment-specific templates. '''''(since 0.11)'''''
+ * `templates` - Custom Genshi environment-specific templates. ''(since 0.11)''
    * `site.html` - method to customize header, footer, and style, described in TracInterfaceCustomization#SiteAppearance
 
-'''Caveat:''' ''don't confuse a Trac environment directory with the source code repository directory.'' 
+=== Caveat: don't confuse a ''Trac environment directory'' with the ''source code repository directory'' #Caveat
 
 This is a common beginners' mistake.
@@ -150 +155 @@
 ----
 See also: TracAdmin, TracBackup, TracIni, TracGuide
-