Changes between Version 3 and Version 4 of TracModPython


Ignore:
Timestamp:
Aug 20, 2024, 2:02:54 PM (2 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracModPython

    v3 v4  
    5555  SetHandler mod_python
    5656  PythonInterpreter main_interpreter
    57   PythonHandler trac.web.modpython_frontend 
     57  PythonHandler trac.web.modpython_frontend
    5858  PythonOption TracEnv /var/trac/myproject
    5959  PythonOption TracUriRoot /projects/myproject
     
    8383PythonOption TracEnvIndexTemplate /srv/www/htdocs/trac/project_list_template.html
    8484
    85 # A space delimitted list, with a "," between key and value pairs.
     85# A space delimited list, with a "," between key and value pairs.
    8686PythonOption TracTemplateVars key1,val1 key2,val2
    8787
     
    8989PythonOption TracLocale en_GB.UTF8
    9090
    91 # See description above       
     91# See description above
    9292PythonOption TracUriRoot /projects/myproject
    9393}}}
     
    110110=== Setting the Python Egg Cache
    111111
    112 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. 
     112If 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.
    113113
    114114{{{#!apache
    115115<Location /projects/myproject>
    116116  ...
    117   PythonOption PYTHON_EGG_CACHE /tmp 
     117  PythonOption PYTHON_EGG_CACHE /tmp
    118118  ...
    119119</Location>
     
    140140  SetHandler mod_python
    141141  PythonInterpreter main_interpreter
    142   PythonHandler trac.web.modpython_frontend 
     142  PythonHandler trac.web.modpython_frontend
    143143  PythonOption TracEnvParentDir /var/trac
    144144  PythonOption TracUriRoot /projects
     
    147147
    148148When 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.
     149
     150Directories 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.
    149151
    150152If you don't want to have the subdirectory listing as your projects home page you can use a
     
    232234
    233235   #remove these if you don't want to force SSL
    234    RewriteEngine On 
     236   RewriteEngine On
    235237   RewriteCond %{HTTPS} off
    236238   RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI}
     
    243245}}}
    244246
    245 === Expat-related segmentation faults === #expat
    246 
    247 This problem will most certainly hit you on Unix when using Python 2.4.
    248 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.
    249 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.
    250 
    251247=== Form submission problems
    252248
     
    277273SetHandler mod_python
    278274PythonInterpreter main_interpreter
    279 PythonHandler trac.web.modpython_frontend 
     275PythonHandler trac.web.modpython_frontend
    280276PythonOption TracEnv /system/path/to/this/directory
    281277PythonOption TracUriRoot /path/on/apache
     
    316312}}}
    317313
    318 See also [http://subversion.apache.org/faq.html#reposperms How do I set repository permissions correctly?]
     314See also [https://subversion.apache.org/faq.html#reposperms How do I set repository permissions correctly?]
    319315
    320316==== FreeBSD issues
     
    359355
    360356'''Note''': For the above configuration to have any effect it must be put after the configuration of your project root location, ie {{{<Location /myproject />}}}.
    361 
    362 **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.
    363357
    364358=== HTTPS issues
     
    376370=== Segmentation fault with php5-mhash or other php5 modules
    377371
    378 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].
    379 
    380 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].
     372You 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].
     373
     374Some 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].
    381375
    382376----