1. Jochen Breuer
  2. Mercurial Wiki


Clone wiki

Mercurial Wiki / Home

ATTENTION - This project moved

This project moved to GitHub.

Mercurial Wiki

Mercurial Wiki is a wiki with the sole purpose to be embedded into a Mercurial repository. Everyone who clones the repository will automatically get the wiki documentation with all the information needed to get started or the latest changes for the project or branch. Regardless if you are sitting in a plane or travel in nature without internet connection, all the important information are stored right in the repository just with the code. The Markdown markup is used to format and layout the wiki pages. Up until version 1.2 creole markup was used.


Mercurial Wiki requires bottle.py, Jinja2, markdown2 and of course Mercurial. You can install the dependencies with pip install -r requirements.txt. But you should create a virtualenv first: virtualenv --distribute --no-site-packages env. And don't forget to activate it with . env/bin/activate.


Download Mercurial Wiki und extract anywhere. Now cd to your ~/bin or /usr/local/bin folder and create a symlink (ln -s <path> hgwiki) to the hgwiki.py. Now you can change to a local Mercurial repository (only base path works for now) and enter hgwiki. A browser window opens and shows the start page.

Installation for Ubuntu 12.04 Precise

A ready to install package for Ubuntu 12.04 Precise can be found in Downloads.

The fpm makefile for this package can be found in my fpm makefiles repository.