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
 89## sidebar on the repository index page
 90#index-info=
 91
 92
 93## If specified, the file at this path will be included as HTML above
 94## the repository index
 95#index-header=
 96
 97
 98## Link to css file
 99#css=/cgit/cgit.css
100
101
102## Link to logo file
103#logo=/cgit/git-logo.png
104
105
106## Url loaded when clicking the logo
107#logo-link=http://www.kernel.org/pub/software/scm/git/docs/
108
109
110## Url loaded when clicking a submodule link
111#module-link=./?repo=%s&page=commit&id=%s
112
113
114## Number of chars shown of repo description (in repolist view)
115#max-repodesc-length=60
116
117
118## Number of chars shown of commit subject message (in log view)
119#max-message-length=60
120
121
122## Number of commits per page in log view
123#max-commit-count=50
124
125
126## Root of cached output
127#cache-root=/var/cache/cgit
128
129
130## Include another config-file
131#include=/var/cgit/repolist
132
133##
134## Time-To-Live settings: specifies how long (in minutes) different pages
135## should be cached (0 for instant expiration, -1 for immortal pages)
136##
137
138## ttl for root page
139#cache-root-ttl=5
140
141## ttl for repo summary page
142#cache-repo-ttl=5
143
144## ttl for other dynamic pages
145#cache-dynamic-ttl=5
146
147## ttl for static pages (addressed by SHA-1)
148#cache-static-ttl=-1
149
150
151
152## Example repository entry. Required values are repo.url and repo.path (each
153## repository section must start with repo.url).
154#repo.url=cgit
155#repo.name=cgit
156#repo.desc=the caching cgi for git
157#repo.path=/pub/git/cgit			## this is the path to $GIT_DIR
158#repo.owner=Lars Hjemli
159#repo.defbranch=master				## define a default branch
160#repo.snapshots=tar.bz2				## override a sitewide snapshot-setting
161#repo.enable-log-filecount=0			## override the default filecount setting
162#repo.enable-log-linecount=0			## override the default linecount setting
163#repo.module-link=/git/%s/commit/?id=%s		## override the standard module-link
164#repo.readme=info/web/readme			## specify a file to include on summary page
165
166## Additional repositories grouped under "mirrors"
167#repo.group=mirrors
168
169#repo.url=git
170#repo.path=/pub/git/git
171#
172#repo.url=linux
173#repo.path=/pub/git/linux
174
175## A group of private repositories (with a working directory)
176#repo.group=private
177
178#repo.url=larsh/cgit
179#repo.path=/home/larsh/src/cgit/.git
180
181#repo.url=larsh/git
182#repo.path=/home/larsh/src/git/.git