Commits

Anonymous committed f4bd793

One step closer to a release...

Comments (0)

Files changed (7)

 recursive-include doc *
 recursive-include wiki-default *
 recursive-include templates *.cs README
-prune *~
-prune *.tmp
-prune *.bak
-prune *.old
+prune doc/trac-guide
 prune .svn 
 prune */.svn
 prune */*/.svn
 prune */*/*/.svn
 prune */*/*/*/.svn
+global-exclude *~
+global-exclude *.tmp
+global-exclude *.bak
+global-exclude *.old
-= Trac Installation Guide =
+Trac Installation Guide
+-----------------------
 
 The Trac web-based project management tool is implemented as a server side
 cgi-program. Trac is written in the Python programming language and store it's
 data in a sqlite database.
 
-== Dependencies ==
+Dependencies
+------------
 
 The following dependencies have to be installed:
 
-  * Python, version >= 2.1.
-  * subversion, version >= 0.29.
-  * pysqlite, version >= 0.4.3
-  * ClearSilver, version >= 0.9.3
-  * A CGI-capable webserver (only tested with Apache)
+  * Python, version >= 2.1. http://python.org/
+  * subversion, version >= 0.37. http://subversion.tigris.org/
+  * pysqlite, version >= 0.4.3. http://pysqlite.sf.net/
+  * ClearSilver, version >= 0.9.3. http://clearsilver.net/
+  * A CGI-capable web server (only tested with Apache)
 
-== Installing Trac ==
+Installing Trac
+---------------
 
- $ python ./setup.py build
- $ python ./setup.py install
+        $ python ./setup.py install
 
-== Initializing the database ==
+This will byte-compile the python source code and install it in the
+site-packages directory of your python installation. The directories templates,
+htdocs and wiki-default will be copied into $prefix/share/trac/ .
 
-Trac stores wiki pages, tickes and other information in a sqlite database.
-Sqlite databases ar just ordinary files on the harddrive, no database server is
-required.
+Initializing the database
+-------------------------
+
+Trac stores wiki pages, tickets and other information in a sqlite database.
+Sqlite databases are just ordinary files on the hard drive, no database server
+is required.
 
 A new trac database can be created like this:
 
- $ trac_admin.py /path/to/mydatabase.db initdb
+        $ trac-admin /path/to/mydatabase.db initdb
 
-NOTE: The database file have to be located in a directory where the webserver
+NOTE: The database file have to be located in a directory where the web server
 user has write permission to both the file and the directory.
 
-This creates a new database using default values. Some settings still need to
-be modified to get your Trac installation up and running. The following command
-will display the trac configuration:
+trac-admin will ask you where your subversion repository is located and where
+it can find the trac templates directory (the default value should be fine).
 
- $ trac_admin.py /path/to/mydatabase.db config list
+Configuring Apache
+------------------
 
-Most settings should be okey, but you have to verify that these settings are
-correct:
+copy (or symlink) "trac/cgi-bin/trac.cgi" to you web servers /cgi-bin/
+directory. Of course you can configure apache to use the "trac/cgi-bin/"
+directory directly if you like.
 
-  * general.repository_dir. This should be the path to the svn repository.
-  * general.templates_dir. This should be the path to the trac template
-    directory.
-
-A config value is modified like this:
-
- $ trac_admin.py /path/to/mydatabase.db config set <name> <value>
-
-== Configuring Apache ==
-
-copy "trac/cgi-bin/trac.cgi" to you webservers /cgi-bin/ directory. Of course
-you can configure apache to use the "trac/cgi-bin/" directory directly if you
-like.
-
-Finally adjust the filenames and add this config snippet to your webserver:
+Finally adjust the filenames and add this config snippet to your web server:
 
 Alias /trac/ "/where/you/put/trac/htdocs/"
 # Trac need to know where the database is located
 <Location "/cgi-bin/trac.cgi">
-     SetEnv TRAC_DB "/somewhere/myproject.db"
+        SetEnv TRAC_DB "/somewhere/myproject.db"
 </Location>
 
-# You need this to let users authenticate
+# You need this to allow users to authenticate
 <Location "/cgi-bin/trac.cgi/login">
-     AuthType Basic
-     AuthName "trac"
-     AuthUserFile /somewhere/trac.htpasswd
-     Require valid-user
+        AuthType Basic
+        AuthName "trac"
+        AuthUserFile /somewhere/trac.htpasswd
+        Require valid-user
 </location>
 
-== What next? ==
+What next?
 
 You should now have a working Trac installation at:
 

scripts/trac-admin

 #!/usr/bin/env python
 # -*- coding: iso8859-1 -*-
-__version__ = '0.1'
+__version__ = '0.5'
 __author__ = 'Daniel Lundin <daniel@edgewall.com>, Jonas Borgstr�m <jonas@edgewall.com>'
 __copyright__ = 'Copyright (c) 2004 Edgewall Research & Development'
 __license__ = """
             if arg[0]  == 'list':
                 self._do_wiki_list()
             elif arg[0] == 'import' and len(arg) == 3:
-                file = arg[1]
-                title = arg[2]
+                title = arg[1]
+                file = arg[2]
                 self._do_wiki_import(file, title)
             elif arg[0] == 'export'  and len(arg) in [2,3]:
                 page = arg[1]

templates/footer.cs

      src="<?cs var:htdocs_location?>/trac.png" 
       width="103" height="20" alt="[Trac Logo] " /></a> 
   <div id="footer-left">
-    Powered by <a href="http://trac.edgewall.com/">Trac 0.1</a><br />
+    Powered by <a href="http://trac.edgewall.com/">Trac <?cs var:trac.version ?></a><br />
     By <a href="http://www.edgewall.com/">Edgewall Research &amp;
 Development</a>.
   </div>
         self.cgi.hdf.setValue('trac.href.login', href.login())
         self.cgi.hdf.setValue('trac.href.logout', href.logout())
         self.cgi.hdf.setValue('trac.href.homepage', 'http://trac.edgewall.com/')
-        self.cgi.hdf.setValue('trac.version', '0.1')
+        self.cgi.hdf.setValue('trac.version', '0.5')
 
         
         self.cgi.hdf.setValue('header_logo.link',
 """
 __docformat__ = 'epytext en'
 
-__version__ = '0.1'
+__version__ = '0.5'
 __url__ = 'http://trac.edgewall.com/'
 __copyright__ = '(C) 2003 Edgewall Research & Development'
 __license__ = 'GNU General Public License version 2'

wiki-default/TracInstall

 The following dependencies have to be installed:
 
  * [http://www.python.org/ Python], version >= 2.1.
- * [http://subversion.tigris.org/ subversion], version >= 0.29.
+ * [http://subversion.tigris.org/ subversion], version >= 0.37.
  * [http://pysqlite.sf.net/ pysqlite], version >= 0.4.3
  * [http://clearsilver.net/ ClearSilver], version >= 0.9.3
  * A CGI-capable web server (only tested with Apache)
 
 == Installing Trac ==
 {{{
-	$ python ./setup.py build
 	$ python ./setup.py install
 }}}
+
+This will byte-compile the python source code and install it in the {{{site-packages}}} directory
+of your python installation. The directories {{{templates}}}, {{{htdocs}}} and {{{wiki-default}}}
+will be copied into $prefix/share/trac/ . 
+
 == Initializing the database ==
 
 Trac stores wiki pages, tickets and other information in a sqlite database. 
 
 A new trac database can be created like this:
 
- {{{$ trac_admin.py /path/to/mydatabase.db initdb}}}
+{{{
+	$ trac-admin /path/to/mydatabase.db initdb
+}}}
 
 NOTE: The database file have to be located in a directory where the web server
 user has write permission to both the file and the directory.
 
-This creates a new database using default values. Some settings still need
-to be modified to get your Trac installation up and running. The following
-command will display the trac configuration:
-
- {{{$ trac_admin.py /path/to/mydatabase.db config list}}}
-
-Most settings should be okay, but you have to verify that these settings
-are correct:
- * general.repository_dir. This should be the path to the svn repository.
- * general.templates_dir. This should be the path to the trac template directory.
-
-A config value is modified like this:
-
- {{{$ trac_admin.py /path/to/mydatabase.db config set <name> <value>}}}
+{{{[wiki:TracAdmin trac-admin]}}} will ask you where your subversion repository is located and
+where it can find the trac templates directory (the default value should be fine).
 
 == Configuring Apache ==
 
-copy "{{{trac/cgi-bin/trac.cgi}}}" to 
+copy (or symlink) "{{{trac/cgi-bin/trac.cgi}}}" to 
 you web servers {{{/cgi-bin/}}} directory. Of course you can configure apache
 to use the "{{{trac/cgi-bin/}}}" directory directly if you like.
 
 Alias /trac/ "/where/you/put/trac/htdocs/"
 # Trac need to know where the database is located
 <Location "/cgi-bin/trac.cgi">
-  SetEnv TRAC_DB "/somewhere/myproject.db"
+	SetEnv TRAC_DB "/somewhere/myproject.db"
 </Location>
 
-# You need this to let users authenticate
+# You need this to allow users to authenticate
 <Location "/cgi-bin/trac.cgi/login">
-  AuthType Basic
-  AuthName "trac"
-  AuthUserFile /somewhere/trac.htpasswd
-  Require valid-user
+	AuthType Basic
+	AuthName "trac"
+	AuthUserFile /somewhere/trac.htpasswd
+	Require valid-user
 </location>
-
 }}}
 
 == What next? ==
 
 Enjoy!
 
---------------------------
-TracGuide <- TracGuide -> TracAdmin.
+
+