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
47 ## Enable/disable display of localtime vs. GMT. Set to 1 for localtime.
50 ## The "Idle" column on the repository index page can read a timestamp
51 ## from the specified agefile (if this file cannot be found, the mtime
53 ## The cgit repo on hjemli.net uses the the following command in it's
54 ## post-receive hook to update the age-file:
55 ## git-for-each-ref --format="%(committerdate)" --sort=-committerdate \
56 ## --count=1 > $GIT_DIR/info/web/last-modifie
58 #agefile=info/web/last-modified
61 ## Git detects renames, but with a limit on the number of files to
62 ## consider. This option can be used to specify another limit (or -1 to
63 ## use the default limit).
68 ## Specify a root for virtual urls. This makes cgit generate urls like
70 ## http://localhost/git/repo/log/?h=branch
74 ## http://localhost/cgit/cgit.cgi?url=repo/log&h=branch
76 ## For this to work with apache, a rewrite rule must be added to httpd.conf,
77 ## possibly looking something like this:
79 ## RewriteRule ^/git/(.*)$ /cgit/cgit.cgi?url=$1 [L,QSA]
81 ## For this to work with lighttpd, the rewrite rule should look more like this:
84 ## "^/git/([^?/]+/[^?]*)?(?:\?(.*))?$" => "/cgit.cgi?url=$1&$2"
87 ## This setting is disabled by default.
91 ## Set the title printed on the root page
92 #root-title=Git repository browser
95 ## Set the description printed on the root page
96 #root-desc=a fast web interface for the git dscm
99 ## If specified, the file at this path will be included as HTML in the
100 ## sidebar on the repository index page
104 ## If specified, the file at this path will be included as HTML above
105 ## the repository index
113 #favicon=/favicon.ico
116 #logo=/cgit/git-logo.png
119 ## Url loaded when clicking the logo
120 #logo-link=http://www.kernel.org/pub/software/scm/git/docs/
123 ## Url loaded when clicking a submodule link
124 #module-link=./?repo=%s&page=commit&id=%s
127 ## Shared prefix which, when combined with repo url, becomes the url used
132 ## Number of chars shown of repo description (in repolist view)
133 #max-repodesc-length=60
136 ## Number of chars shown of commit subject message (in log view)
137 #max-message-length=60
140 ## Number of commits per page in log view
144 ## Root of cached output
145 #cache-root=/var/cache/cgit
148 ## Include another config-file
149 #include=/var/cgit/repolist
152 ## Time-To-Live settings: specifies how long (in minutes) different pages
153 ## should be cached (0 for instant expiration, -1 for immortal pages)
159 ## ttl for repo summary page
162 ## ttl for other dynamic pages
165 ## ttl for static pages (addressed by SHA-1)
170 ## Example repository entry. Required values are repo.url and repo.path (each
171 ## repository section must start with repo.url).
174 #repo.desc=the caching cgi for git
175 #repo.path=/pub/git/cgit ## this is the path to $GIT_DIR
176 #repo.owner=Lars Hjemli
177 #repo.defbranch=master ## define a default branch
178 #repo.snapshots=tar.bz2 ## override a sitewide snapshot-setting
179 #repo.enable-log-filecount=0 ## override the default filecount setting
180 #repo.enable-log-linecount=0 ## override the default linecount setting
181 #repo.module-link=/git/%s/commit/?id=%s ## override the standard module-link
182 #repo.readme=info/web/readme ## specify a file to include on summary page
183 #repo.clone-url=git://hjemli.net/pub/git/cgit
185 ## Additional repositories grouped under "mirrors"
189 #repo.path=/pub/git/git
190 #repo.clone-url=git://hjemli.net/pub/git/git
193 #repo.path=/pub/git/linux
195 ## A group of private repositories (with a working directory)
199 #repo.path=/home/larsh/src/cgit/.git
202 #repo.path=/home/larsh/src/git/.git