Changes between Version 11 and Version 12 of TracPrettyUrls

Timestamp:

Dec 31, 2007, 1:06:16 PM (16 years ago)

Author:

techtonik <techtonik@…>

Comment:

+ another way to make pretty URL via .htaccess

TracPrettyUrls

@@ -9 +9 @@
 http://<subdomain>.<yourhostname>/
 
-this is one way, using mod_rewrite (in Apache):
+there are several ways to do this on Apache:
 
-load the module mod_rewrite, then, place this in your apache config:
+=== Using mod_rewrite through httpd.conf ===
+If you have access to your Apache config, load the module mod_rewrite, then, place this in the config:
 (if you have subdomain, inside a !VirtualHost)
 
@@ -35 +36 @@
 }}}
 
-'''Also Note:''' Another simple way to do this is to put a redirect in {{{/usr/share/trac/htdocs/index.html}}}, such as:
+=== Using mod_rewrite from .htaccess files ===
+Make an .htaccess file or add the following lines into existing if it's already present in your site directory with trac.fcgi
+{{{
+RewriteEngine On
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule ^(.*)$ /trac.fcgi/$1 [L,QSA]
+RewriteRule ^$ trac.fcgi [L]
+}}}
+
+Two RewriteCond strings tell Apache do not fire redirection to Trac script if there is existing file or directory with requested name. The last rule works always and redirects root site requests to TracCGI script. If you want to explicitly exclude some paths from being handled by Trac (such as /stats URLs or /phpmyadmin etc. usually provided by hostings) then insert the third RewriteCond right after the second one.
+{{{
+RewriteCond %{REQUEST_URI} !^/(stats/|phpmyadmin) [NC]
+}}}
+
+=== Easy access URL as a last resort ===
+The above configurations of Apache will not allow user to see "cgi-bin" or "trac.cgi" string in Trac URLs. However, if you just want to automatically redirect users from your site root to trac page - put a redirect in {{{/usr/share/trac/htdocs/index.html}}}, such as:
 
 {{{<META HTTP-EQUIV="Refresh" CONTENT="0; URL=/cgi-bin/trac.cgi">}}}