Changes between Version 1 and Version 2 of TracModPython


Ignore:
Timestamp:
10/22/08 03:31:28 (10 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracModPython

    v1 v2  
    4949 
    5050The option '''`TracUriRoot`''' may or may not be necessary in your setup. Try your configuration without it; if the URLs produced by Trac look wrong, if Trac does not seem to recognize URLs correctly, or you get an odd "No handler matched request to..." error, add the '''`TracUriRoot`''' option.  You will notice that the `Location` and '''`TracUriRoot`''' have the same path. 
     51 
     52The options available are 
     53{{{ 
     54    # For a single project 
     55    PythonOption TracEnv /var/trac/myproject 
     56    # For multiple projects 
     57    PythonOption TracEnvParentDir /var/trac/myprojects 
     58    # For the index of multiple projects 
     59    PythonOption TracEnvIndexTemplate /srv/www/htdocs/trac/project_list_tepmlate.html 
     60    # A space delimitted list, with a "," between key and value pairs. 
     61    PythonOption TracTemplateVars key1,val1 key2,val2 
     62    # Useful to get the date in the wanted order 
     63    PythonOption TracLocale en_GB.UTF8 
     64    # See description above         
     65    PythonOption TracUriRoot /projects/myproject 
     66    # Override default python egg cache location 
     67    PythonOption PYTHON_EGG_CACHE /var/trac/myprojects/egg-cache 
     68}}} 
    5169 
    5270=== Configuring Authentication === 
     
    205223For a virtual host that supports multiple projects replace "`TracEnv`" /var/trac/myproject with "`TracEnvParentDir`" /var/trac/ 
    206224 
     225Note: !DocumentRoot should not point to your Trac project env. As Asmodai wrote on #trac: "suppose there's a webserer bug that allows disclosure of !DocumentRoot they could then leech the entire Trac environment". 
     226 
    207227== Troubleshooting == 
    208228 
     
    220240=== Expat-related segmentation faults === #expat 
    221241 
    222 This problem will most certainly hit you on Unix when using python 2.4. 
     242This problem will most certainly hit you on Unix when using Python 2.4. 
    223243In Python 2.4, some version of Expat (an XML parser library written in C) is used,  
    224244and if Apache is using another version, this results in segmentation faults. 
    225 As Trac 0.11 is using Genshi, which will use indirectly use Expat, that problem 
     245As Trac 0.11 is using Genshi, which will indirectly use Expat, that problem 
    226246can now hit you even if everything was working fine before with Trac 0.10. 
    227247 
     
    266286Pay attention to the version of the installed mod_python and sqlite packages. Ports have both the new and old ones, but earlier versions of pysqlite and mod_python won't integrate as the former requires threaded support in python, and the latter requires a threadless install. 
    267287 
    268 If you compiled and installed apache2, apache wouldn´t support threads (cause it doesn´t work very well on FreeBSD). You could force thread support when running ./configure for apache, using --enable-threads, but this isn´t recomendable. 
     288If you compiled and installed apache2, apache wouldn´t support threads (cause it doesn´t work very well on FreeBSD). You could force thread support when running ./configure for apache, using --enable-threads, but this isn´t recommendable. 
    269289The best option [[http://modpython.org/pipermail/mod_python/2006-September/021983.html seems to be]] adding to /usr/local/apache2/bin/ennvars the line  
    270290