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

= Add sub projects to your Trac environment

== Description

This 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: `/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 
[report:9?COMPONENT=SubProjectsPatch here].

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

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

== Download

Download the zipped source from [export:subprojectspatch here].

== Source

Check out SubProjectsPatch from [/svn/subprojectspatch here] 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'.

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:'''