xref: /cgit/
NameDateSize

..16-Mar-201612 KiB

.gitignore29-Dec-2012141

.gitmodules29-Dec-201278

cache.c05-Mar-201310 KiB

cache.h29-Dec-20121 KiB

cgit-doc.css29-Dec-201242

cgit.c05-Mar-201325.5 KiB

cgit.css05-Mar-201312.6 KiB

cgit.h05-Mar-20137.1 KiB

cgit.png29-Dec-20121.5 KiB

cgitrc.5.txt05-Mar-201323.8 KiB

cmd.c05-Mar-20133.7 KiB

cmd.h29-Dec-2012301

configfile.c05-Mar-20131.4 KiB

configfile.h29-Dec-2012220

COPYING29-Dec-201217.6 KiB

filters/05-Mar-20134 KiB

gen-version.sh29-Dec-2012392

git/14-May-20124 KiB

html.c05-Mar-20136.9 KiB

html.h29-Dec-20121 KiB

Makefile05-Mar-20136.6 KiB

parsing.c05-Mar-20134.9 KiB

README05-Mar-20132.3 KiB

scan-tree.c05-Mar-20135.7 KiB

scan-tree.h29-Dec-2012150

shared.c05-Mar-201312.3 KiB

tests/05-Mar-20134 KiB

ui-atom.c29-Dec-20123.1 KiB

ui-atom.h29-Dec-2012112

ui-blob.c05-Mar-20133.1 KiB

ui-blob.h29-Dec-2012195

ui-clone.c05-Mar-20132.2 KiB

ui-clone.h29-Dec-2012211

ui-commit.c05-Mar-20134 KiB

ui-commit.h29-Dec-2012129

ui-diff.c05-Mar-201310.7 KiB

ui-diff.h29-Dec-2012517

ui-log.c05-Mar-201310.8 KiB

ui-log.h05-Mar-2013278

ui-patch.c05-Mar-20133.4 KiB

ui-patch.h29-Dec-2012125

ui-plain.c05-Mar-20135.4 KiB

ui-plain.h29-Dec-2012120

ui-refs.c05-Mar-20135.8 KiB

ui-refs.h29-Dec-2012182

ui-repolist.c05-Mar-20137.4 KiB

ui-repolist.h29-Dec-2012146

ui-shared.c05-Mar-201324.9 KiB

ui-shared.h29-Dec-20123.2 KiB

ui-snapshot.c05-Mar-20135.2 KiB

ui-snapshot.h29-Dec-2012191

ui-ssdiff.c05-Mar-20139.1 KiB

ui-ssdiff.h29-Dec-2012479

ui-stats.c05-Mar-20139.6 KiB

ui-stats.h29-Dec-2012638

ui-summary.c05-Mar-20133 KiB

ui-summary.h29-Dec-2012152

ui-tag.c05-Mar-20132.4 KiB

ui-tag.h29-Dec-2012101

ui-tree.c05-Mar-20137 KiB

ui-tree.h29-Dec-2012119

vector.c29-Dec-2012762

vector.h29-Dec-2012292

README

1
2                       cgit - cgi for git
3
4
5This is an attempt to create a fast web interface for the git scm, using a
6builtin cache to decrease server io-pressure.
7
8
9Installation
10
11Building cgit involves building a proper version of git. How to do this
12depends on how you obtained the cgit sources:
13
14a) If you're working in a cloned cgit repository, you first need to
15initialize and update the git submodule:
16
17  $ git submodule init     # register the git submodule in .git/config
18  $ $EDITOR .git/config    # if you want to specify a different url for git
19  $ git submodule update   # clone/fetch and checkout correct git version
20
21b) If you're building from a cgit tarball, you can download a proper git
22version like this:
23
24  $ make get-git
25
26
27When either a) or b) has been performed, you can build and install cgit like
28this:
29
30  $ make
31  $ sudo make install
32
33This will install cgit.cgi and cgit.css into "/var/www/htdocs/cgit". You can
34configure this location (and a few other things) by providing a "cgit.conf"
35file (see the Makefile for details).
36
37
38Dependencies:
39  -git 1.7.4
40  -zip lib
41  -crypto lib
42  -openssl lib
43
44
45Apache configuration
46
47A new Directory-section must probably be added for cgit, possibly something
48like this:
49
50  <Directory "/var/www/htdocs/cgit/">
51      AllowOverride None
52      Options +ExecCGI
53      Order allow,deny
54      Allow from all
55  </Directory>
56
57
58Runtime configuration
59
60The file /etc/cgitrc is read by cgit before handling a request. In addition
61to runtime parameters, this file may also contain a list of repositories
62displayed by cgit (see cgitrc.5.txt for further details).
63
64
65The cache
66
67When cgit is invoked it looks for a cachefile matching the request and
68returns it to the client. If no such cachefile exist (or if it has expired),
69the content for the request is written into the proper cachefile before the
70file is returned.
71
72If the cachefile has expired but cgit is unable to obtain a lock for it, the
73stale cachefile is returned to the client. This is done to favour page
74throughput over page freshness.
75
76The generated content contains the complete response to the client, including
77the http-headers "Modified" and "Expires".
78
79
80Online presence
81
82* The cgit homepage is hosted by cgit at http://git.zx2c4.com/cgit/about
83
84* Patches, bugreports, discussions and support should go to the cgit
85  mailing list: cgit@hjemli.net
86