Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 5fb43ebc98
Fetching contributors…

Cannot retrieve contributors at this time

74 lines (52 sloc) 2.145 kb

klaus

a simple Git web viewer that Just Works™. (If it doesn't Just Work for you, please file a bug.)

Demo at http://klausdemo.lophus.org

img1 img2 img3

Requirements

  • Python 2.7
  • Jinja2
  • Pygments
  • dulwich (>= 0.7.1)
  • argparse (only for Python 2.6)
  • Nano (shipped as submodule, do a git submodule update --init to fetch)

Installation

The same procedure as every year, James.

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

git clone https://github.com/jonashaag/klaus
cd klaus
git submodule update --init
pip install -r requirements.txt

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 ..." ...
Jump to Line
Something went wrong with that request. Please try again.