2 ## cgitrc: template for /etc/cgitrc
6 ## Uncomment and set to 1 to deactivate caching of generated pages. Mostly
7 ## usefull for testing.
11 ## This variable can be used to override the default value for "robots"
12 ## meta-tag. If unset, the meta-tag isn't generated.
13 #robots=index, nofollow
16 ## Set allowed snapshot types by default. Can be overridden per repo
17 # can be any combination of zip/tar.gz/tar.bz2/tar
21 ## Enable/disable extra links to summary/log/tree per repo on index page
25 ## Enable/disable display of 'number of files changed' in log view
26 #enable-log-filecount=0
29 ## Enable/disable display of 'number of lines changed' in log view
30 #enable-log-linecount=0
33 ## Enable/disable display of HEAD shortlog in summary view. Set it to maximum
34 ## number of commits that should be displayed
38 ## Restrict the number of branches printed in summary view. Set to 0 to
39 ## print all branches.
43 ## Restrict the number of tags printed in summary view. Set to 0 to
48 ## The "Idle" column on the repository index page can read a timestamp
49 ## from the specified agefile (if this file cannot be found, the mtime
51 ## The cgit repo on hjemli.net uses the the following command in it's
52 ## post-receive hook to update the age-file:
53 ## git-for-each-ref --format="%(committerdate)" --sort=-committerdate \
54 ## --count=1 > $GIT_DIR/info/web/last-modifie
56 #agefile=info/web/last-modified
59 ## Git detects renames, but with a limit on the number of files to
60 ## consider. This option can be used to specify another limit (or -1 to
61 ## use the default limit).
66 ## Specify a root for virtual urls. This makes cgit generate urls like
68 ## http://localhost/git/repo/log/?h=branch
72 ## http://localhost/cgit/cgit.cgi?url=repo/log&h=branch
74 ## For this to work with apache, a rewrite rule must be added to httpd.conf,
75 ## possibly looking something like this:
77 ## RewriteRule ^/git/(.*)$ /cgit/cgit.cgi?url=$1 [L,QSA]
79 ## For this to work with lighttpd, the rewrite rule should look more like this:
82 ## "^/git/([^?/]+/[^?]*)?(?:\?(.*))?$" => "/cgit.cgi?url=$1&$2"
85 ## This setting is disabled by default.
89 ## Set the title printed on the root page
90 #root-title=Git repository browser
93 ## If specified, the file at this path will be included as HTML in the
94 ## sidebar on the repository index page
98 ## If specified, the file at this path will be included as HTML above
99 ## the repository index
108 #logo=/cgit/git-logo.png
111 ## Url loaded when clicking the logo
112 #logo-link=http://www.kernel.org/pub/software/scm/git/docs/
115 ## Url loaded when clicking a submodule link
116 #module-link=./?repo=%s&page=commit&id=%s
119 ## Shared prefix which, when combined with repo url, becomes the url used
124 ## Number of chars shown of repo description (in repolist view)
125 #max-repodesc-length=60
128 ## Number of chars shown of commit subject message (in log view)
129 #max-message-length=60
132 ## Number of commits per page in log view
136 ## Root of cached output
137 #cache-root=/var/cache/cgit
140 ## Include another config-file
141 #include=/var/cgit/repolist
144 ## Time-To-Live settings: specifies how long (in minutes) different pages
145 ## should be cached (0 for instant expiration, -1 for immortal pages)
151 ## ttl for repo summary page
154 ## ttl for other dynamic pages
157 ## ttl for static pages (addressed by SHA-1)
162 ## Example repository entry. Required values are repo.url and repo.path (each
163 ## repository section must start with repo.url).
166 #repo.desc=the caching cgi for git
167 #repo.path=/pub/git/cgit ## this is the path to $GIT_DIR
168 #repo.owner=Lars Hjemli
169 #repo.defbranch=master ## define a default branch
170 #repo.snapshots=tar.bz2 ## override a sitewide snapshot-setting
171 #repo.enable-log-filecount=0 ## override the default filecount setting
172 #repo.enable-log-linecount=0 ## override the default linecount setting
173 #repo.module-link=/git/%s/commit/?id=%s ## override the standard module-link
174 #repo.readme=info/web/readme ## specify a file to include on summary page
175 #repo.clone-url=git://hjemli.net/pub/git/cgit
177 ## Additional repositories grouped under "mirrors"
181 #repo.path=/pub/git/git
182 #repo.clone-url=git://hjemli.net/pub/git/git
185 #repo.path=/pub/git/linux
187 ## A group of private repositories (with a working directory)
191 #repo.path=/home/larsh/src/cgit/.git
194 #repo.path=/home/larsh/src/git/.git