Changes between Version 4 and Version 5 of TracLegosConfiguration


Ignore:
Timestamp:
Feb 9, 2009 11:38:50 PM (5 years ago)
Author:
k0s
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracLegosConfiguration

    v4 v5  
    55[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]. 
    66 
    7 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.   
     7In 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.  
     8 
     9== Site Configuration Example == 
     10 
     11An example site configuration is at source:traclegosscript/anyrelease/example/topp/site.ini : 
     12 
     13[[Include(source:traclegosscript/anyrelease/example/topp/site.ini)]] 
     14 
     15== Use of [TracLegosScript TracLegos] Site Configuration == 
    816 
    917[[Image(source:traclegosscript/anyrelease/image/traclegos-conf.png)]] 
     18 
     19This diagram illustrates the use of [TracLegosScript TracLegos] site configuration via three major methods of invocation: 
     20 
     21 * via `create-trac-project -c` 
     22 * via the web interface invoked by `paster serve` 
     23 * via API calls to `TracLegos.create_project` 
     24 
     25Running `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`. 
     26