blob: 36d2d488348b693a1842c01c3a1e09526c1a5d0b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
klaus
=====
*a simple Git web viewer that Just Works™.*
|img1|_ |img2|_ |img3|_
.. |img1| image:: https://github.com/jonashaag/klaus/raw/master/assets/commit-view.thumb.gif
.. |img2| image:: https://github.com/jonashaag/klaus/raw/master/assets/tree-view.thumb.gif
.. |img3| image:: https://github.com/jonashaag/klaus/raw/master/assets/blob-view.thumb.gif
.. _img1: https://github.com/jonashaag/klaus/raw/master/assets/commit-view.gif
.. _img2: https://github.com/jonashaag/klaus/raw/master/assets/tree-view.gif
.. _img3: https://github.com/jonashaag/klaus/raw/master/assets/blob-view.gif
Requirements
------------
* Python 2.7
* Jinja2_ (``pip install jinja2``)
* Pygments_ (``pip install pygments``)
* dulwich_ (``pip install dulwich``)
* Nano_ (``git submodule update --init``)
.. _Jinja2: http://jinja.pocoo.org/
.. _Pygments: http://pygments.org/
.. _dulwich: http://www.samba.org/~jelmer/dulwich/
.. _Nano: https://github.com/jonashaag/nano
Usage
-----
Using the ``quickstart.py`` script
..................................
::
./quickstart --help
./quickstart.py <host> <port> /path/to/repo1 [../path/to/repo2 [...]]
Example::
./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).
.. _wsgiref: http://docs.python.org/library/wsgiref.html
.. _bjoern: https://github.com/jonashaag/bjoern
Using a real server
...................
The ``klaus.py`` module contains an ``app`` object that is a WSGI application.
|
