Changes between Version 5 and Version 6 of TracModPython

Timestamp:

Feb 24, 2024, 4:07:16 PM (9 months ago)

Author:

trac

Comment:

--

TracModPython

@@ -55 +55 @@
   SetHandler mod_python
   PythonInterpreter main_interpreter
-  PythonHandler trac.web.modpython_frontend 
+  PythonHandler trac.web.modpython_frontend
   PythonOption TracEnv /var/trac/myproject
   PythonOption TracUriRoot /projects/myproject
@@ -83 +83 @@
 PythonOption TracEnvIndexTemplate /srv/www/htdocs/trac/project_list_template.html
 
-# A space delimitted list, with a "," between key and value pairs.
+# A space delimited list, with a "," between key and value pairs.
 PythonOption TracTemplateVars key1,val1 key2,val2
 
@@ -89 +89 @@
 PythonOption TracLocale en_GB.UTF8
 
-# See description above        
+# See description above
 PythonOption TracUriRoot /projects/myproject
 }}}
@@ -110 +110 @@
 === Setting the Python Egg Cache
 
-If the Egg Cache isn't writeable by your Web server, you'll either have to change the permissions, or point Python to a location where Apache can write. This can manifest itself as a `500 internal server error` and/or a complaint in the syslog. 
+If the Egg Cache isn't writeable by your Web server, you'll either have to change the permissions, or point Python to a location where Apache can write. This can manifest itself as a `500 internal server error` and/or a complaint in the syslog.
 
 {{{#!apache
 <Location /projects/myproject>
   ...
-  PythonOption PYTHON_EGG_CACHE /tmp 
+  PythonOption PYTHON_EGG_CACHE /tmp
   ...
 </Location>
@@ -140 +140 @@
   SetHandler mod_python
   PythonInterpreter main_interpreter
-  PythonHandler trac.web.modpython_frontend 
+  PythonHandler trac.web.modpython_frontend
   PythonOption TracEnvParentDir /var/trac
   PythonOption TracUriRoot /projects
@@ -147 +147 @@
 
 When you request the `/projects` URL, you will get a listing of all subdirectories of the directory you set as `TracEnvParentDir` that look like Trac environment directories. Selecting any project in the list will bring you to the corresponding Trac environment.
+
+Directories residing in `TracEnvParentDir` that are not environment directories will display an error message on the [TracInterfaceCustomization#ProjectList project index page]. The directories can be excluded by listing them in a `.tracignore` file residing in `TracEnvParentDir`. Unix [https://docs.python.org/2/library/fnmatch.html shell-style wildcard patterns] can be used in the newline separated list of directories.
 
 If you don't want to have the subdirectory listing as your projects home page you can use a
@@ -232 +234 @@
 
    #remove these if you don't want to force SSL
-   RewriteEngine On 
+   RewriteEngine On
    RewriteCond %{HTTPS} off
    RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI}
@@ -243 +245 @@
 }}}
 
-=== Expat-related segmentation faults === #expat
-
-This problem will most certainly hit you on Unix when using Python 2.4.
-In Python 2.4, some version of [http://expat.sourceforge.net/ Expat] (an XML parser library written in C) is used and if Apache is using another version, this results in segmentation faults.
-As Trac 0.11 is using Genshi, which will indirectly use Expat, that problem can now hit you even if everything was working fine before with Trac 0.10. This problem has not been reported for Python 2.5+, so best to upgrade.
-
 === Form submission problems
 
@@ -277 +273 @@
 SetHandler mod_python
 PythonInterpreter main_interpreter
-PythonHandler trac.web.modpython_frontend 
+PythonHandler trac.web.modpython_frontend
 PythonOption TracEnv /system/path/to/this/directory
 PythonOption TracUriRoot /path/on/apache
@@ -316 +312 @@
 }}}
 
-See also [http://subversion.apache.org/faq.html#reposperms How do I set repository permissions correctly?]
+See also [https://subversion.apache.org/faq.html#reposperms How do I set repository permissions correctly?]
 
 ==== FreeBSD issues
@@ -359 +355 @@
 
 '''Note''': For the above configuration to have any effect it must be put after the configuration of your project root location, ie {{{<Location /myproject />}}}.
-
-**Note:** Do not enable python optimizations using the directive `PythonOptimize On`. When optimizations are enabled the page header/footer and documentation for macros and plugins will be hidden. An error will be raised in Trac 1.0.11 and later when optimizations are enabled.
 
 === HTTPS issues
@@ -376 +370 @@
 === Segmentation fault with php5-mhash or other php5 modules
 
-You may encounter segfaults (reported on Debian etch) if php5-mhash module is installed. Try to remove it to see if this solves the problem. See [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411487 Debian bug report].
-
-Some people also have troubles when using PHP5 compiled with its own third party libraries instead of system libraries. Check [http://www.djangoproject.com/documentation/modpython/#if-you-get-a-segmentation-fault Django segmentation fault].
+You may encounter segfaults (reported on Debian etch) if php5-mhash module is installed. Try to remove it to see if this solves the problem. See [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411487 Debian bug report].
+
+Some people also have troubles when using PHP5 compiled with its own third party libraries instead of system libraries. Check [https://www.djangoproject.com/documentation/modpython/#if-you-get-a-segmentation-fault Django segmentation fault].
 
 ----