Changes between Version 11 and Version 12 of 0.12/TracInstall

Timestamp:

Feb 3, 2010, 11:26:04 AM (14 years ago)

Author:

Christian Boos

Comment:

updated the intro and #Prerequisites section

0.12/TracInstall

@@ -9 +9 @@
 Trac is written in the Python programming language and needs a database, [http://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL], or [http://mysql.com/ MySQL]. For HTML rendering, Trac uses the [http://genshi.edgewall.org Genshi] templating system.
 
-Since version 0.12, Trac can also be localized, and there's probably a translation available for your language. If you want to be able to use the Trac interface in other languages, then make sure you have installed the optional package [#OtherPythonPackages Babel]. Pay attention to the extra steps for localization support in the [#InstallingTrac Installing Trac] section below. Note Trac can still be installed without Babel, but then you will only get the default english version, as usual.
+Since version 0.12, Trac can also be localized, and there's probably a translation available for your language. If you want to be able to use the Trac interface in other languages, then make sure you have installed the optional package [#OtherPythonPackages Babel]. Pay attention to the extra steps for localization support in the [#InstallingTrac Installing Trac] section below. Lacking Babel, you will only get the default english version, as usual.
 
 If you're interested in contributing new translations for other languages or enhance the existing translations, then please have a look at ["TracL10N"].
@@ -17 +17 @@
 
 == Prerequisites ==
-
+=== Mandatory Prerequisites
 To install Trac, the following software packages must be installed:
 
  * [http://www.python.org/ Python], version >= 2.4 (we dropped the support for Python 2.3 in this release)
  * [http://peak.telecommunity.com/DevCenter/setuptools setuptools], version >= 0.6
- * [http://genshi.edgewall.org/wiki/Download Genshi], [genshi:source:trunk trunk], from svn, minimum required revision is [G1072].
- * You also need a database system and the corresponding python drivers for it.
-   The database can be either SQLite, PostgreSQL or MySQL.
-
-=== For SQLite ===
+ * [http://genshi.edgewall.org/wiki/Download Genshi], [genshi:source:trunk trunk], from svn, minimum required revision is [G1072], current [G1092] works fine as well.
+
+You also need a database system and the corresponding python bindings.
+The database can be either SQLite, PostgreSQL or MySQL.
+
+==== For the SQLite database #ForSQLite
 
 If you're using Python 2.5 or 2.6, you already have everything you need.
@@ -47 +48 @@
 See additional information in [trac:PySqlite PySqlite].
 
-=== For PostgreSQL ===
+==== For the PostgreSQL database #ForPostgreSQL
 
 You need to install the database and its Python bindings:
  * [http://www.postgresql.org/ PostgreSQL]
- * [http://initd.org/projects/psycopg2 psycopg2]
-
-See [trac:DatabaseBackend#Postgresql DatabaseBackend] for details
-
-
-=== For MySQL ===
+ * [http://pypi.python.org/pypi/psycopg2 psycopg2]
+
+See [trac:DatabaseBackend#Postgresql DatabaseBackend] for details.
+
+
+==== For the MySQL database #ForMySQL
 
 Trac can now work quite well with MySQL, provided you follow the guidelines.
@@ -63 +64 @@
  * [http://sf.net/projects/mysql-python MySQLdb], version 1.2.2 or later
 
-See [trac:MySqlDb MySqlDb] for more detailed information.
-It is ''very'' important to read carefully that page before creating the database.
-
-=== Optional Requirements ===
+It is '''very''' important to read carefully the  [trac:MySqlDb MySqlDb] page before creating the database.
+
+=== Optional Prerequisites
 
 ==== Version Control System ====
 
 ===== Subversion =====
-'''Please note:''' if using Subversion, Trac must be installed on the '''same machine'''. Remote repositories are currently not supported.
-
- * [http://subversion.tigris.org/ Subversion], version >= 1.0. (versions recommended: 1.2.4, 1.3.2 or 1.4.2) and the '''''corresponding''''' Python bindings. For troubleshooting, check [trac:TracSubversion TracSubversion]
-   [[br]] ''FIXME'' upgrade the requirements; it makes no sense to still support 1.0 or even 1.3, as Subversion itself only still supports 1.4.x
-   * Trac uses the [http://svnbook.red-bean.com/svnbook-1.1/ch08s02.html#svn-ch-8-sect-2.3 SWIG] bindings included in the Subversion distribution, '''not''' [http://pysvn.tigris.org/ PySVN] (which is sometimes confused with the standard SWIG bindings), neither does it support the newer `ctype`-style bindings
-   * If Subversion was already installed without the SWIG bindings, on Unix you'll need to re-`configure` Subversion and `make swig-py`, `make install-swig-py`.
-   * There are [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 pre-compiled bindings] available for win32. 
+ * [http://subversion.apache.org/ Subversion], 1.5.x or 1.6.x and the '''''corresponding''''' Python bindings. Actually older versions starting from 1.0, like 1.2.4, 1.3.2 or 1.4.2, etc. should still work. For troubleshooting information, check the [trac:TracSubversion#Troubleshooting TracSubversion] page/
+
+There are [http://subversion.apache.org/packages.html pre-compiled SWIG bindings] available for various platforms. Note that Trac '''doesn't''' use [http://pysvn.tigris.org/ PySVN], neither does it work yet with the newer `ctype`-style bindings
+
+
+'''Please note:''' if using Subversion, Trac must be installed on the '''same machine'''. Remote repositories are currently [trac:ticket:493 not supported].
+
 
 ===== Others =====
@@ -90 +90 @@
    server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp]), or
  * [http://httpd.apache.org/ Apache] with 
-   - [http://code.google.com/p/modwsgi/ mod_wsgi], see [wiki:TracModWSGI] or 
+   - [http://code.google.com/p/modwsgi/ mod_wsgi], see [wiki:TracModWSGI] and 
      http://code.google.com/p/modwsgi/wiki/IntegrationWithTrac
    - [http://modpython.org/ mod_python 3.3.1], see TracModPython)