Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
the first Git web viewer that Just Works™.
branch: master

This branch is 55 commits ahead, 245 commits behind jonashaag:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
assets
nano @ 03bd20f
static
templates
tools
.gitignore
.gitmodules
LICENSE
README.rst
TODO
diff.py
klaus.py
repo.py

README.rst

klaus

a simple Git web viewer that Just Works™. (beta quality)

Demo at http://klausdemo.lophus.org

img1 img2 img3

Requirements

Installation

The same procedure as every year, James.

virtualenv your-env
source your-env/bin/activate

pip install jinja2
pip install pygments
pip install dulwich

git clone https://github.com/jonashaag/klaus
cd klaus
git submodule update --init

Usage

Using the quickstart.py script

tools/quickstart --help
tools/quickstart.py <host> <port> /path/to/repo1 [../path/to/repo2 [...]]

Example:

tools/quickstart.py 127.0.0.1 8080 ../klaus ../nano ../bjoern

This will make klaus serve the klaus, nano and bjoern repos at 127.0.0.1:8080 using Python's built-in wsgiref server (or, if installed, the bjoern server).

Using a real server

The klaus.py module contains a WSGI application object. The repo list is read from the KLAUS_REPOS environment variable (space-separated paths).

UWSGI example:

uwsgi ... -m klaus --env KLAUS_REPOS="/path/to/repo1 /path/to/repo2 ..." ...
Something went wrong with that request. Please try again.