Changes between Version 4 and Version 5 of TracLegosConfiguration

Timestamp:

Feb 9, 2009, 10:38:50 PM (15 years ago)

Author:

Jeff Hammel

Comment:

--

TracLegosConfiguration

@@ -5 +5 @@
 [TracLegosScript TracLegos] is designed to support several ways of creating trac projects: from the command line (`create-trac-project`), via a [http://pythonpaste.org paster] [source:traclegosscript/anyrelease/traclegos/web.py web interface], and via API calls to [source:traclegosscript/anyrelease/traclegos/legos.py#L100 TracLegos.create_project] and support functions such as [source:traclegosscript/anyrelease/traclegos/legos#L253].
 
-In all three cases, you can have a site configuration file.  The site configuration file contains [TracLegosTemplate template] variables appropriate to the particular site as well driven configuration defining the project directory, database type, a default set of templates, and other configuration needed to define trac project creation.  
+In all three cases, you can have a site configuration file.  The site configuration file contains [TracLegosTemplates template] variables appropriate to the particular site as well driven configuration defining the project directory, database type, a default set of templates, and other configuration needed to define trac project creation.  A site configuration `.ini` file may be used to enable a trac project creation policy, whether by convention (using `create-trac-project` from the command line) or by enforcement (using the web front end).  The site configuration is tailored to the needs of a particular site or organization and so is not useful to share.  Contrast this to [TracLegosTemplates trac project templates] which are generally meant to be generic and therefore sharable. 
+
+== Site Configuration Example ==
+
+An example site configuration is at source:traclegosscript/anyrelease/example/topp/site.ini :
+
+[[Include(source:traclegosscript/anyrelease/example/topp/site.ini)]]
+
+== Use of [TracLegosScript TracLegos] Site Configuration ==
 
 [[Image(source:traclegosscript/anyrelease/image/traclegos-conf.png)]]
+
+This diagram illustrates the use of [TracLegosScript TracLegos] site configuration via three major methods of invocation:
+
+ * via `create-trac-project -c`
+ * via the web interface invoked by `paster serve`
+ * via API calls to `TracLegos.create_project`
+
+Running `create-trac-projct -c site-configuration.ini` will read the variables and defaults from the `site-configuration.ini` file.  Additional parameters and variables passed via the command line will override those in `site-configuration.ini`.
+