PublishingRepositories2

Publishing Repositories (all-in-one howto)

Work in progress, any help apreciated!

Right now, we have too many documents describing the same stuff over and over again. We need to merge and clean up the following pages: PublishingRepositories, ServerInstall, HgWebDirStepByStep, ["mod_wsgi"] (and possibly ["SharedSSH"])

- Instructions should be distribution/OS agnostic (at least for Unix-like operating systems).BR - Examples should be consistent; e.g. use hg.example.net as a domain name, /srv/www/vhosts/hg.example.net for DocumentRoot ...BR - Keep it simple, stupid (compare mod_rewrite vs. ScriptAliasMatch setup in PublishingRepositories).BR - We should target competent users/admins. So don't describe basic Apache configuration or similar.BR

Basic page structure should look like this:

Publishing method:

• Built in web server (hg serve)
• "Real" web server (apache, lighttpd):
  • CGI
  • FastCGI
  • mod_wsgi

• hgweb.cgi vs. hgwebdir.cgi (who has only one repo anyway?)

Mercurial configuration:

• hgweb.config
• repo specific customization (.hg/hgrc)
• theming

Pushing changes:

• http(s)
• ssh

Start here