Changes between Version 16 and Version 17 of TracLegosScript

Timestamp:

Sep 18, 2008, 9:42:04 PM (16 years ago)

Author:

Jeff Hammel

Comment:

--

TracLegosScript

@@ -31 +31 @@
 [/newticket?component=TracLegosScript&owner=k0s new ticket].
 
-== Download and Source ==
+== Installation and Setup ==
 
 Download the [download:traclegosscript zipped source], check out [/svn/traclegosscript using Subversion], or [source:traclegosscript browse the source] with Trac.
+
+Installation is done in the typical python manner.  Once you have downloaded the source, run {{{python setup.py install}}} for installation into python's site packages or {{{python setup.py develop}}} to install with edittable source.
+
+=== Installation of Example Template ===
+
+TracLegosScript also comes with an existing template:  source:traclegosscript/anyrelease/example/topp, which is an example of the kind of template used at [http://topp.openplans.org/ The Open Planning Project].  To install this template, run {{{python setup.py install}}} or {{{python setup.py develop}}} from this directory.  This [http://pythonpaste.org/script/developer.html#templates PasteScript template] can be seen in the output of `paster create --list-templates`:
+
+{{{
+(TracLegos)> paster create --list-templates
+Available templates:
+  basic_package:      A basic setuptools-enabled package
+  paste_deploy:       A web application deployed through paste.deploy
+  topp_trac_project:  The Open Planning Project Trac Template
+  trac_project:       templatize configuration for a trac project
+}}}
+
+=== Setup of WebOb View for Project Creation ===
+
+!TracLegos includes a [http://pythonpaste.org paste] webapp that serves existing projects (delegating to trac) and also allows creating new projects.  In order to use this view, you must have at least one template installed, so first install the example template as described above.  Once the {{{topp_trac_template}}} (or any other template) is installed, you should be all set to run the webapp by running {{{paster serve development.ini}}} from the top-level directory of your copy of the !TracLegos source (source:traclegosscript/anyrelease/development.ini).
+
+Point your browser at http://127.0.0.1:8080 and you should be all set with a bare-bones web-based trac project creator.
+
+=== Turning an Existing {{{trac.ini}}} File into a Template ===
+
+'''TODO'''
 
 == Example ==