Changes between Version 3 and Version 4 of 0.12/TracInstall

Timestamp:

May 12, 2008, 9:46:00 AM (16 years ago)

Author:

Christian Boos

Comment:

How to install localized versions of Trac

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 0.12, Trac can also be localized, and there's probably a translation available for your language. If you're interested to contribute new translations for other languages or enhance the existing translations, please have a look at ["TracL10N"].
+Since 0.12, Trac can also be localized, and there's probably a translation available for your language. If this is what you want, then make sure you have installed the optional package [#OtherPythonUtilities Babel]. Trac can still be installed without Babel, but then you will only get the 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"].
 
 What follows are generic instructions for installing and setting up Trac and its requirements. While you can find instructions for installing Trac on specific systems at TracInstallPlatforms on the main Trac site, please be sure to '''first read through these general instructions''' to get a good understanding of the tasks involved.
@@ -93 +94 @@
 One way to install Trac is using `setuptools`.
 With setuptools you can install Trac from the subversion repository; for example,
-to install release version 0.11rc1 do:
-{{{
-easy_install http://svn.edgewall.org/repos/trac/tags/trac-0.11rc1
+to install release version 0.12dev do:
+{{{
+easy_install http://svn.edgewall.org/repos/trac/trunk
 }}}
 
@@ -102 +103 @@
 $ python ./setup.py install
 }}}
-
-''Note: you'll need root permissions or equivalent for this step.''
+See SubversionRepository for details about getting the source.
+
+''Note 1: you'll need root permissions or equivalent for this step.'' [[br]]
+''Note 2: installing from source is the preferred method if you want to have a localized version of Trac'' [[br]]
 
 This will byte-compile the python source code and install it as an .egg file or folder in the `site-packages` directory
@@ -109 +112 @@
 
 The script will also install the [wiki:TracAdmin trac-admin] command-line tool, used to create and maintain [wiki:TracEnvironment project environments], as well as the [wiki:TracStandalone tracd] standalone server.
+
+If you want to make Trac available in other languages, make sure you have installed Babel and then run this additional step before doing the `install` (or simply redo the `install` afterwards):
+{{{
+$ python ./setup.py compile_catalog -f
+}}}
+(the `-f` flag is needed as long as some translations are marked ''fuzzy'', i.e. incomplete, which will most probably be the case during the whole development period, as  strings are continuously added or modified)
 
 === Advanced Options ===