| | 2 | |
| | 3 | == Specifying repositories |
| | 4 | Starting with 0.12, Trac can handle more than one repository per environment. The pre-0.12 way of specifying the repository with the `repository_dir` and `repository_type` options in the `[trac]` section of [wiki:TracIni trac.ini] is still supported, but two new mechanisms allow including additional repositories into an environment. |
| | 5 | |
| | 6 | It is also possible to define aliases of repositories, that act as "pointers" to real repositories. This can be useful when renaming a repository, to avoid breaking all the links to the old name. |
| | 7 | |
| | 8 | A number of attributes can be associated with each repository, and define the location of the repository, its type, name and how it is displayed in the source browser. The following attributes are supported: |
| | 9 | |
| | 10 | ||='''Attribute''' =||='''Description''' =|| |
| | 11 | ||`alias` ||\ |
| | 12 | ||A repository having an `alias` attribute is an alias to a real repository. All TracLinks referencing the alias resolve to the aliased repository. Note that multiple indirection is not supported, so an alias must always point to a real repository. The `alias` and `dir` attributes are mutually exclusive. || |
| | 13 | ||`description` ||\ |
| | 14 | ||The text specified in the `description` attribute is displayed below the top-level entry for the repository in the source browser. It supports WikiFormatting. || |
| | 15 | ||`dir` ||\ |
| | 16 | ||The `dir` attribute specifies the location of the repository in the filesystem. It corresponds to the value previously specified in the option `[trac] repository_dir`. The `alias` and `dir` attributes are mutually exclusive. || |
| | 17 | ||`hidden` ||When set to `true`, the repository is hidden from the repository index page in the source browser. Browsing the repository is still possible, and links referencing the repository remain valid. || |
| | 18 | ||`name` ||The `name` attribute specifies the leading path element to the repository. || |
| | 19 | ||`type` ||The `type` attribute sets the type of version control system used by the repository. Trac supports Subversion out-of-the-box, and plugins add support for many other systems. If `type` is not specified, it defaults to the value of the `[trac] repository_type` option. || |
| | 20 | ||`url` ||The `url` attribute specifies the root URL to be used for checking out from the repository. When specified, a "Repository URL" link is added to the context navigation links in the source browser, that can be copied into the tool used for creating the working copy. || |
| | 21 | |
| | 22 | The `name` attribute and one of `alias` or `dir` are mandatory. All others are optional. |
| | 23 | |
| | 24 | === In `trac.ini` |
| | 25 | A new section `[repositories]` |
| | 26 | |
| | 27 | === Using the "Repositories" admin panel |
| | 28 | |
| | 29 | |
| | 30 | == Repository synchronization |
| | 31 | |
