hgweb.txt
46 lines
| 1.7 KiB
| text/plain
|
TextLexer
|
r10999 | Mercurial's internal web server, hgweb, can serve either a single | ||
repository, or a collection of them. In the latter case, a special | ||||
configuration file can be used to specify the repository paths to use | ||||
and global web configuration options. | ||||
|
r13838 | This file uses the same syntax as other Mercurial configuration files, | ||
but only the following sections are recognized: | ||||
|
r10999 | |||
- web | ||||
- paths | ||||
- collections | ||||
The ``web`` section can specify all the settings described in the web | ||||
section of the hgrc documentation. | ||||
The ``paths`` section provides mappings of physical repository | ||||
paths to virtual ones. For instance:: | ||||
[paths] | ||||
projects/a = /foo/bar | ||||
projects/b = /baz/quux | ||||
web/root = /real/root/* | ||||
/ = /real/root2/* | ||||
virtual/root2 = /real/root2/** | ||||
- The first two entries make two repositories in different directories | ||||
appear under the same directory in the web interface | ||||
- The third entry maps every Mercurial repository found in '/real/root' | ||||
into 'web/root'. This format is preferred over the [collections] one, | ||||
since using absolute paths as configuration keys is not supported on every | ||||
platform (especially on Windows). | ||||
- The fourth entry is a special case mapping all repositories in | ||||
'/real/root2' in the root of the virtual directory. | ||||
- The fifth entry recursively finds all repositories under the real | ||||
root, and maps their relative paths under the virtual root. | ||||
The ``collections`` section provides mappings of trees of physical | ||||
repositories paths to virtual ones, though the paths syntax is generally | ||||
preferred. For instance:: | ||||
[collections] | ||||
/foo = /foo | ||||
Here, the left side will be stripped off all repositories found in the | ||||
right side. Thus ``/foo/bar`` and ``foo/quux/baz`` will be listed as | ||||
``bar`` and ``quux/baz`` respectively. | ||||