cgitrc (view raw)
1##
2## cgitrc: template for /etc/cgitrc
3##
4
5
6## Uncomment and set to 1 to deactivate caching of generated pages. Mostly
7## usefull for testing.
8#nocache=0
9
10
11## Set allowed snapshot types by default. Can be overridden per repo
12# can be any combination of zip/tar.gz/tar.bz2/tar
13#snapshots=0
14
15
16## Enable/disable extra links to summary/log/tree per repo on index page
17#enable-index-links=0
18
19
20## Enable/disable display of 'number of files changed' in log view
21#enable-log-filecount=0
22
23
24## Enable/disable display of 'number of lines changed' in log view
25#enable-log-linecount=0
26
27
28## Enable/disable display of HEAD shortlog in summary view. Set it to maximum
29## number of commits that should be displayed
30#summary-log=0
31
32
33## The "Idle" column on the repository index page can read a timestamp
34## from the specified agefile (if this file cannot be found, the mtime
35## of HEAD is used).
36## The cgit repo on hjemli.net uses the the following command in it's
37## post-receive hook to update the age-file:
38## git-for-each-ref --format="%(committerdate)" --sort=-committerdate \
39## --count=1 > $GIT_DIR/info/web/last-modifie
40##
41#agefile=info/web/last-modified
42
43
44## Specify a root for virtual urls. This makes cgit generate urls like
45##
46## http://localhost/git/repo/log/?h=branch
47##
48## instead of
49##
50## http://localhost/cgit/cgit.cgi?url=repo/log&h=branch
51##
52## For this to work with apache, a rewrite rule must be added to httpd.conf,
53## possibly looking something like this:
54##
55## RewriteRule ^/git/(.*)$ /cgit/cgit.cgi?url=$1 [L,QSA]
56##
57## For this to work with lighttpd, the rewrite rule should look more like this:
58##
59## url.rewrite = (
60## "^/git/([^?/]+/[^?]*)?(?:\?(.*))?$" => "/cgit.cgi?url=$1&$2"
61## )
62##
63## This setting is disabled by default.
64#virtual-root=/git
65
66
67## Set the title printed on the root page
68#root-title=Git repository browser
69
70
71## If specified, the file at this path will be included as HTML in the index
72## of repositories
73#index-header=
74
75
76## Link to css file
77#css=/cgit/cgit.css
78
79
80## Link to logo file
81#logo=/cgit/git-logo.png
82
83
84## Url loaded when clicking the logo
85#logo-link=http://www.kernel.org/pub/software/scm/git/docs/
86
87
88## Url loaded when clicking a submodule link
89#module-link=./?repo=%s&page=commit&id=%s
90
91
92## Number of chars shown of repo description (in repolist view)
93#max-repodesc-length=60
94
95
96## Number of chars shown of commit subject message (in log view)
97#max-message-length=60
98
99
100## Number of commits per page in log view
101#max-commit-count=50
102
103
104## Root of cached output
105#cache-root=/var/cache/cgit
106
107
108## Include another config-file
109#include=/var/cgit/repolist
110
111##
112## Time-To-Live settings: specifies how long (in minutes) different pages
113## should be cached (0 for instant expiration, -1 for immortal pages)
114##
115
116## ttl for root page
117#cache-root-ttl=5
118
119## ttl for repo summary page
120#cache-repo-ttl=5
121
122## ttl for other dynamic pages
123#cache-dynamic-ttl=5
124
125## ttl for static pages (addressed by SHA-1)
126#cache-static-ttl=-1
127
128
129
130## Example repository entry. Required values are repo.url and repo.path (each
131## repository section must start with repo.url).
132#repo.url=cgit
133#repo.name=cgit
134#repo.desc=the caching cgi for git
135#repo.path=/pub/git/cgit ## this is the path to $GIT_DIR
136#repo.owner=Lars Hjemli
137#repo.defbranch=master ## define a default branch
138#repo.snapshots=tar.bz2 ## override a sitewide snapshot-setting
139#repo.enable-log-filecount=0 ## override the default filecount setting
140#repo.enable-log-linecount=0 ## override the default linecount setting
141#repo.module-link=/git/%s/commit/?id=%s ## override the standard module-link
142#repo.readme=info/web/readme ## specify a file to include on summary page
143
144## Additional repositories grouped under "mirrors"
145#repo.group=mirrors
146
147#repo.url=git
148#repo.path=/pub/git/git
149#
150#repo.url=linux
151#repo.path=/pub/git/linux
152
153## A group of private repositories (with a working directory)
154#repo.group=private
155
156#repo.url=larsh/cgit
157#repo.path=/home/larsh/src/cgit/.git
158
159#repo.url=larsh/git
160#repo.path=/home/larsh/src/git/.git