[[PageOutline(2-5,Contents,pullout)]]

= Add sub projects to you Trac environment

== Description ==

This hack is a patch that allows you to have a Trac environment parent directory under another Trac environment in a directory called 'projects'. The subprojects are then accessible via the URL of the parent project slash 'p' slash sub project name. 

For example: `/parentproject/p/childproject`.

It only works when using an environment parent directory for the top level.

== Bugs/Feature Requests

Existing bugs and feature requests for SubProjectsPatch are 
[query:?status=new&status=assigned&status=reopened&group=&component=SubProjectsPatch&order=priority here].

If you have any issues, create a 
[/newticket?component=SubProjectsPatch new ticket].

[[TicketQuery(component=SubProjectsPatch&group=type,format=progress)]]

== Download and Source

Download [download:subprojectspatch the zipped source], check out [http://trac-hacks.org/svn/subprojectspatch using Subversion], or [source:subprojectspatch browse the source] with Trac.

== Configuration

Follow these generic guidelines to apply this patch:

 1. Apply the patch to `trac/web/main.py`. 
 1. Create an environment called 'foo'. 
 1. Create a directory in 'foo' called 'projects'. 
 1. Create another environment inside 'projects' called 'bar'. 
 1. Restart tracd and point the env-parent-dir to the parent of 'foo'.

== Example

You should now be able to go to both `/foo` and see project `foo`, and go to `/foo/p/bar` and see project `bar`, with valid URL generation and all other navigation. 

== Recent Changes

[[ChangeLog(subprojectspatch, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:progrium] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''