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## Restrict the number of branches printed in summary view. Set to 0 to
34## print all branches.
35#summary-branches=0
36
37
38## Restrict the number of tags printed in summary view. Set to 0 to
39## print all tags.
40#summary-tags=0
41
42
43## The "Idle" column on the repository index page can read a timestamp
44## from the specified agefile (if this file cannot be found, the mtime
45## of HEAD is used).
46## The cgit repo on hjemli.net uses the the following command in it's
47## post-receive hook to update the age-file:
48## git-for-each-ref --format="%(committerdate)" --sort=-committerdate \
49## --count=1 > $GIT_DIR/info/web/last-modifie
50##
51#agefile=info/web/last-modified
52
53
54## Git detects renames, but with a limit on the number of files to
55## consider. This option can be used to specify another limit (or -1 to
56## use the default limit).
57##
58#renamelimit=-1
59
60
61## Specify a root for virtual urls. This makes cgit generate urls like
62##
63## http://localhost/git/repo/log/?h=branch
64##
65## instead of
66##
67## http://localhost/cgit/cgit.cgi?url=repo/log&h=branch
68##
69## For this to work with apache, a rewrite rule must be added to httpd.conf,
70## possibly looking something like this:
71##
72## RewriteRule ^/git/(.*)$ /cgit/cgit.cgi?url=$1 [L,QSA]
73##
74## For this to work with lighttpd, the rewrite rule should look more like this:
75##
76## url.rewrite = (
77## "^/git/([^?/]+/[^?]*)?(?:\?(.*))?$" => "/cgit.cgi?url=$1&$2"
78## )
79##
80## This setting is disabled by default.
81#virtual-root=/git
82
83
84## Set the title printed on the root page
85#root-title=Git repository browser
86
87
88## If specified, the file at this path will be included as HTML in the index
89## of repositories
90#index-header=
91
92
93## Link to css file
94#css=/cgit/cgit.css
95
96
97## Link to logo file
98#logo=/cgit/git-logo.png
99
100
101## Url loaded when clicking the logo
102#logo-link=http://www.kernel.org/pub/software/scm/git/docs/
103
104
105## Url loaded when clicking a submodule link
106#module-link=./?repo=%s&page=commit&id=%s
107
108
109## Number of chars shown of repo description (in repolist view)
110#max-repodesc-length=60
111
112
113## Number of chars shown of commit subject message (in log view)
114#max-message-length=60
115
116
117## Number of commits per page in log view
118#max-commit-count=50
119
120
121## Root of cached output
122#cache-root=/var/cache/cgit
123
124
125## Include another config-file
126#include=/var/cgit/repolist
127
128##
129## Time-To-Live settings: specifies how long (in minutes) different pages
130## should be cached (0 for instant expiration, -1 for immortal pages)
131##
132
133## ttl for root page
134#cache-root-ttl=5
135
136## ttl for repo summary page
137#cache-repo-ttl=5
138
139## ttl for other dynamic pages
140#cache-dynamic-ttl=5
141
142## ttl for static pages (addressed by SHA-1)
143#cache-static-ttl=-1
144
145
146
147## Example repository entry. Required values are repo.url and repo.path (each
148## repository section must start with repo.url).
149#repo.url=cgit
150#repo.name=cgit
151#repo.desc=the caching cgi for git
152#repo.path=/pub/git/cgit ## this is the path to $GIT_DIR
153#repo.owner=Lars Hjemli
154#repo.defbranch=master ## define a default branch
155#repo.snapshots=tar.bz2 ## override a sitewide snapshot-setting
156#repo.enable-log-filecount=0 ## override the default filecount setting
157#repo.enable-log-linecount=0 ## override the default linecount setting
158#repo.module-link=/git/%s/commit/?id=%s ## override the standard module-link
159#repo.readme=info/web/readme ## specify a file to include on summary page
160
161## Additional repositories grouped under "mirrors"
162#repo.group=mirrors
163
164#repo.url=git
165#repo.path=/pub/git/git
166#
167#repo.url=linux
168#repo.path=/pub/git/linux
169
170## A group of private repositories (with a working directory)
171#repo.group=private
172
173#repo.url=larsh/cgit
174#repo.path=/home/larsh/src/cgit/.git
175
176#repo.url=larsh/git
177#repo.path=/home/larsh/src/git/.git