Changes between Version 5 and Version 6 of TracInstall

Timestamp:

Oct 1, 2024, 10:09:32 PM (6 weeks ago)

Author:

trac

Comment:

--

TracInstall

@@ -8 +8 @@
 If you're interested in contributing new translations for other languages or enhancing the existing translations, please have a look at [trac:wiki:TracL10N TracL10N].
 
-What follows are generic instructions for installing and setting up Trac. While you may find instructions for installing Trac on specific systems at [trac:TracInstallPlatforms TracInstallPlatforms], please '''first read through these general instructions''' to get a good understanding of the tasks involved.
+These are generic instructions for installing and setting up Trac. While you may find instructions for installing Trac on specific systems at [trac:TracInstallPlatforms TracInstallPlatforms], please '''first read through these general instructions''' to get a good understanding of the tasks involved.
 
 [[PageOutline(2-3,Installation Steps,inline)]]
@@ -14 +14 @@
 == Dependencies
 === Mandatory Dependencies
+
 To install Trac, the following software packages must be installed:
 
@@ -20 +21 @@
  * [https://pypi.org/project/Jinja2 Jinja2], version >= 2.9.3
 
-You also need a database system and the corresponding python bindings. The database can be either SQLite, PostgreSQL or MySQL.
+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
@@ -49 +50 @@
 ==== Subversion
 
-[https://subversion.apache.org/ Subversion], 1.14.x or later and the '''''corresponding''''' Python bindings.
+[https://subversion.apache.org/ Subversion], 1.14.x or later and the '''corresponding''' Python bindings.
 
 There are [https://subversion.apache.org/packages.html pre-compiled SWIG bindings] available for various platforms. See [trac:TracSubversion#GettingSubversion getting Subversion] for more information.
@@ -55 +56 @@
 {{{#!div style="border: 1pt dotted; margin: 1em"
 **Note:**
-* Trac '''doesn't''' use [http://pysvn.tigris.org/ PySVN], nor does it work yet with the newer `ctype`-style bindings.
+* Trac '''doesn't''' use [https://pypi.org/project/PySVN PySVN], nor does it work yet with the newer `ctype`-style bindings.
 * If using Subversion, Trac must be installed on the '''same machine'''. Remote repositories are [trac:ticket:493 not supported].
 }}}
@@ -70 +71 @@
 
 ==== Web Server
+
 A web server is optional because Trac is shipped with a server included, see the [#RunningtheStandaloneServer Running the Standalone Server] section below.
 
@@ -78 +80 @@
    - [http://modpython.org/ mod_python 3.5.0], see TracModPython
  * a [https://fastcgi-archives.github.io FastCGI]-capable web server (see TracFastCgi)
- * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web
-   server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp])
+ * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp])
  * Microsoft IIS with FastCGI and a FastCGI-to-WSGI gateway (see [trac:CookBook/Installation/TracOnWindowsIisWfastcgi IIS with FastCGI])
- * a CGI-capable web server (see TracCgi), '''but usage of Trac as a cgi script
-   is highly discouraged''', better use one of the previous options.
-
+ * a CGI-capable web server (see TracCgi), '''but usage of Trac as a cgi script is highly discouraged''', better use one of the previous options.
 
 ==== Other Python Packages
 
- * [http://babel.pocoo.org Babel], version >= 2.2,
-   needed for localization support
- * [http://pytz.sourceforge.net pytz] to get a complete list of time zones,
-   otherwise Trac will fall back on a shorter list from
-   an internal time zone implementation. Installing Babel
-   will install pytz.
- * [http://docutils.sourceforge.net docutils],
-   version >= 0.14, for WikiRestructuredText.
- * [http://pygments.org Pygments], version >= 1.0,
-   for [TracSyntaxColoring syntax highlighting].
- * [https://pypi.org/project/textile Textile],
-   version >= 2.3,
-   for rendering the [https://github.com/textile/python-textile Textile markup language].
+ * [http://babel.pocoo.org Babel], version >= 2.2, needed for localization support
+ * [http://pytz.sourceforge.net pytz] to get a complete list of time zones, otherwise Trac will fall back on a shorter list from an internal time zone implementation. Installing Babel will install pytz.
+ * [http://docutils.sourceforge.net docutils], version >= 0.14, for WikiRestructuredText.
+ * [http://pygments.org Pygments], version >= 1.0, for [TracSyntaxColoring syntax highlighting].
+ * [https://pypi.org/project/textile Textile], version >= 2.3, for rendering the [https://github.com/textile/python-textile Textile markup language].
  * [https://pypi.org/project/passlib passlib] on Windows to decode [TracStandalone#BasicAuthorization:Usingahtpasswdpasswordfile htpasswd formats] other than `SHA-1`.
  * [https://pypi.org/project/pyreadline pyreadline] on Windows for trac-admin [TracAdmin#InteractiveMode command completion].
@@ -116 +107 @@
 
 === Using `pip`
-`pip` is the modern Python package manager and is included in Python distributions. `pip` will automatically
-resolve the //required// dependencies (Jinja2 and
-setuptools) and download the latest packages from pypi.org.
+
+`pip` is the modern Python package manager and is included in Python distributions. `pip` will automatically resolve the //required// dependencies (Jinja2 and setuptools) and download the latest packages from pypi.org.
 
 You can also install directly from a source package. You can obtain the source in a tar or zip from the [trac:TracDownload] page. After extracting the archive, change to the directory containing `setup.py` and run:
@@ -128 +118 @@
 `pip` supports numerous other install mechanisms. It can be passed the URL of an archive or other download location. Here are some examples:
 
-* Install the latest stable version from a zip archive:
-{{{#!sh
-$ pip install https://download.edgewall.org/trac/Trac-latest.zip
-}}}
 * Install the latest development version from a tar archive:
 {{{#!sh
@@ -138 +124 @@
 * Install the unreleased 1.4-stable from subversion:
 {{{#!sh
-$ pip install svn+https://svn.edgewall.org/repos/trac/branches/1.2-stable
+$ pip install svn+https://svn.edgewall.org/repos/trac/branches/1.4-stable
 }}}
 * Install the latest development preview (//not recommended for production installs//):
@@ -267 +253 @@
 Assuming the deployment has been done this way:
 {{{#!sh
-$ trac-admin /var/trac/<project> deploy /var/www
+$ trac-admin /var/trac/<project> deploy /var/www/trac
 }}}
 
 Add the following snippet to Apache configuration, changing paths to match your deployment. The snippet must be placed ''before'' the `ScriptAlias` or `WSGIScriptAlias` directive, because those directives map all requests to the Trac application:
 {{{#!apache
-Alias /trac/chrome /path/to/trac/htdocs
-
-<Directory "/path/to/www/trac/htdocs">
+Alias /trac/chrome /var/www/trac/htdocs
+
+<Directory "/var/www/trac/htdocs">
   # For Apache 2.2
   <IfModule !mod_authz_core.c>
@@ -330 +316 @@
 == Configuring Authentication
 
-Trac uses HTTP authentication. You'll need to configure your webserver to request authentication when the `.../login` URL is hit (the virtual path of the "login" button). Trac will automatically pick the `REMOTE_USER` variable up after you provide your credentials. Therefore, all user management goes through your web server configuration. Please consult the documentation of your web server for more info.
+Trac uses HTTP authentication. You'll need to configure your web server to request authentication when the `.../login` URL is hit (the virtual path of the "login" button). Trac will automatically pick the `REMOTE_USER` variable up after you provide your credentials. Therefore, all user management goes through your web server configuration. Please consult the documentation of your web server for more info.
 
 The process of adding, removing, and configuring user accounts for authentication depends on the specific way you run Trac.