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