Changes between Version 326 and Version 327 of TracInstall

Timestamp:

Jan 5, 2011, 11:27:54 AM (13 years ago)

Author:

Christian Boos

Comment:

note about first time installation issue with easy_install and moved #Usingpip section down

TracInstall

@@ -138 +138 @@
 A few examples:
 
- - install Trac 0.12:
+ - install Trac 0.12.1 with i18n support:
    {{{
+   easy_install Babel==0.9.5
    easy_install Trac==0.12
+   easy_install -U Trac
    }}}
-
- - install latest development version 0.12dev:
+   ''The upgrade step is a quirk currently necessary to trigger the compilation of the catalog files used for the translations'' (needs to be fixed)
+
+ - install latest stable version of Trac:
    {{{
-   easy_install Trac==dev
+   easy_install -U Trac
    }}}
-   Note that in this case you won't have the possibility to run a localized version of Trac;
-   either use a released version or install from source 
+
+ - install latest trunk development version (0.13dev):
+   {{{
+   easy_install -U Trac==dev
+   }}}
+
+=== From source
+Of course, using the python-typical setup at the top of the source directory also works.
+
+You can obtain the source for a .tar.gz or .zip file corresponding to a release (e.g. Trac-0.12.tar.gz), or you can get the source directly from the repository (see [trac:SubversionRepository] for details).
+
+{{{
+$ python ./setup.py install
+}}}
+
+''You'll need root permissions or equivalent for this step.''
+
+This will byte-compile the python source code and install it as an .egg file or folder in the `site-packages` directory
+of your Python installation. The .egg will also contain all other resources needed by standard Trac, such as htdocs and templates.
+
+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 install from source and want to make Trac available in other languages, make sure  Babel is installed. Only then, perform the `install` (or simply redo the `install` once again afterwards if you realize Babel was not yet installed):
+{{{
+$ python ./setup.py install
+}}}
+Alternatively, you can do a `bdist_egg` and copy the .egg from dist/ to the place of your choice, or you can create a Windows installer (`bdist_wininst`).
+
+=== Advanced Options ===
+
+To install Trac to a custom location, or find out about other advanced installation options, run:
+{{{
+easy_install --help
+}}}
+
+Also see [http://docs.python.org/inst/inst.html Installing Python Modules] for detailed information.
+
+Specifically, you might be interested in:
+{{{
+easy_install --prefix=/path/to/installdir
+}}}
+or, if installing Trac to a Mac OS X system:
+{{{
+easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages
+}}}
+Note: If installing on Mac OS X 10.6 running {{{ easy_install http://svn.edgewall.org/repos/trac/trunk }}} will install into {{{ /usr/local }}} and {{{ /Library/Python/2.6/site-packages }}} by default
+
+The above will place your `tracd` and `trac-admin` commands into `/usr/local/bin` and will install the Trac libraries and dependencies into `/Library/Python/2.5/site-packages`, which is Apple's preferred location for third-party Python application installations.
 
 === Using `pip`
@@ -154 +203 @@
 To get a trac installation up and running in less than 5 minutes:
 
-Assuming you want to have your entire pip installation in /opt/user/trac
+Assuming you want to have your entire pip installation in /opt/user/trac:
 
  - 
@@ -168 +217 @@
 Make sure your OS specific headers are available for pip to automatically build PostgreSQL (libpq-dev) or MySQL (libmysqlclient-dev) bindings.
 
-pip will automatically resolve all dependencies (like Genshi, pygments, etc.) and download the latest packages on pypi.python.org and create a self contained installation in /opt/user/trac 
-
-All commands (tracd, trac-admin) are available in /opt/user/trac/bin . This can also be leveraged for mod_python (using !PythonHandler directive) and mod_wsgi (using WSGIDaemonProcess directive)
+pip will automatically resolve all dependencies (like Genshi, pygments, etc.) and download the latest packages on pypi.python.org and create a self contained installation in /opt/user/trac .
+
+All commands (tracd, trac-admin) are available in /opt/user/trac/bin. This can also be leveraged for mod_python (using !PythonHandler directive) and mod_wsgi (using WSGIDaemonProcess directive)
 
 Additionally, you can install several trac plugins (listed [http://pypi.python.org/pypi?:action=search&term=trac&submit=search here]) through pip.
 
-
-
-=== From source
-Of course, using the python-typical setup at the top of the source directory also works.
-
-You can obtain the source for a .tar.gz or .zip file corresponding to a release (e.g. Trac-0.12.tar.gz), or you can get the source directly from the repository (see [trac:SubversionRepository] for details).
-
-{{{
-$ python ./setup.py install
-}}}
-
-''You'll need root permissions or equivalent for this step.''
-
-This will byte-compile the python source code and install it as an .egg file or folder in the `site-packages` directory
-of your Python installation. The .egg will also contain all other resources needed by standard Trac, such as htdocs and templates.
-
-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 install from source and want to make Trac available in other languages, make sure  Babel is installed. Only then, perform the `install` (or simply redo the `install` once again afterwards if you realize Babel was not yet installed):
-{{{
-$ python ./setup.py install
-}}}
-Alternatively, you can do a `bdist_egg` and copy the .egg from dist/ to the place of your choice, or you can create a Windows installer (`bdist_wininst`).
-
-=== Advanced Options ===
-
-To install Trac to a custom location, or find out about other advanced installation options, run:
-{{{
-easy_install --help
-}}}
-
-Also see [http://docs.python.org/inst/inst.html Installing Python Modules] for detailed information.
-
-Specifically, you might be interested in:
-{{{
-easy_install --prefix=/path/to/installdir
-}}}
-or, if installing Trac to a Mac OS X system:
-{{{
-easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages
-}}}
-Note: If installing on Mac OS X 10.6 running {{{ easy_install http://svn.edgewall.org/repos/trac/trunk }}} will install into {{{ /usr/local }}} and {{{ /Library/Python/2.6/site-packages }}} by default
-
-The above will place your `tracd` and `trac-admin` commands into `/usr/local/bin` and will install the Trac libraries and dependencies into `/Library/Python/2.5/site-packages`, which is Apple's preferred location for third-party Python application installations.