#pragma section-numbers 2
= WebUserDir Extension =

Host users' repositories under /~username/ on hgwebdir.

<<TableOfContents>>

== Status ==

'''This extension is not distributed with Mercurial.'''

''Author: [[YuyaNishihara|Yuya Nishihara]]''

Repository: http://bitbucket.org/yuja/hgext-webuserdir/

== Overview ==

It implements [[http://httpd.apache.org/docs/2.0/mod/mod_userdir.html|Apache-style user repository]] support on hgwebdir.

It will be useful to serve mutable changesets in order to review them, share them temporarily, etc.
You should have shell access to the home directory where you put your repositories.

== Configuration ==
Configure your hgwebdir.config to enable the extension by adding following lines:

{{{
[extensions]
webuserdir = /path/to/webuserdir.py

[web]
# map /~username/ to ~username/public_hg/
userdir = public_hg
# or map to the specific location ( /*/ will be replaced by username)
userdir = /net/host/home/*/public_hg
}}}

You also need to edit hgwebdir.wsgi to load this extension before instantiating hgwebdir object:

{{{#!python
from mercurial import demandimport; demandimport.enable()
from mercurial import extensions, hgweb, ui as uimod
ui = uimod.ui()
ui.readconfig('hgwebdir.config', trust=True)
extensions.loadall(ui)
application = hgweb.hgwebdir('hgwebdir.config', baseui=ui)
# don't use hgwebdir_mod.hgwebdir, which isn't wrapped by webuserdir extension!
}}}

== See also ==

 * [[modwsgi]]

----
CategoryExtensionsByOthers