summaryrefslogtreecommitdiffabout
path: root/cgitrc
Unidiff
Diffstat (limited to 'cgitrc') (more/less context) (ignore whitespace changes)
-rw-r--r--cgitrc2
1 files changed, 2 insertions, 0 deletions
diff --git a/cgitrc b/cgitrc
index f1d8997..9e8a0f2 100644
--- a/cgitrc
+++ b/cgitrc
@@ -1,198 +1,200 @@
1## 1##
2## cgitrc: template for /etc/cgitrc 2## cgitrc: template for /etc/cgitrc
3## 3##
4 4
5 5
6## Uncomment and set to 1 to deactivate caching of generated pages. Mostly 6## Uncomment and set to 1 to deactivate caching of generated pages. Mostly
7## usefull for testing. 7## usefull for testing.
8#nocache=0 8#nocache=0
9 9
10 10
11## This variable can be used to override the default value for "robots" 11## This variable can be used to override the default value for "robots"
12## meta-tag. If unset, the meta-tag isn't generated. 12## meta-tag. If unset, the meta-tag isn't generated.
13#robots=index, nofollow 13#robots=index, nofollow
14 14
15 15
16## Set allowed snapshot types by default. Can be overridden per repo 16## Set allowed snapshot types by default. Can be overridden per repo
17# can be any combination of zip/tar.gz/tar.bz2/tar 17# can be any combination of zip/tar.gz/tar.bz2/tar
18#snapshots=0 18#snapshots=0
19 19
20 20
21## Enable/disable extra links to summary/log/tree per repo on index page 21## Enable/disable extra links to summary/log/tree per repo on index page
22#enable-index-links=0 22#enable-index-links=0
23 23
24 24
25## Enable/disable display of 'number of files changed' in log view 25## Enable/disable display of 'number of files changed' in log view
26#enable-log-filecount=0 26#enable-log-filecount=0
27 27
28 28
29## Enable/disable display of 'number of lines changed' in log view 29## Enable/disable display of 'number of lines changed' in log view
30#enable-log-linecount=0 30#enable-log-linecount=0
31 31
32 32
33## Enable/disable display of HEAD shortlog in summary view. Set it to maximum 33## Enable/disable display of HEAD shortlog in summary view. Set it to maximum
34## number of commits that should be displayed 34## number of commits that should be displayed
35#summary-log=0 35#summary-log=0
36 36
37 37
38## Restrict the number of branches printed in summary view. Set to 0 to 38## Restrict the number of branches printed in summary view. Set to 0 to
39## print all branches. 39## print all branches.
40#summary-branches=0 40#summary-branches=0
41 41
42 42
43## Restrict the number of tags printed in summary view. Set to 0 to 43## Restrict the number of tags printed in summary view. Set to 0 to
44## print all tags. 44## print all tags.
45#summary-tags=0 45#summary-tags=0
46 46
47 47
48## The "Idle" column on the repository index page can read a timestamp 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 49## from the specified agefile (if this file cannot be found, the mtime
50## of HEAD is used). 50## of HEAD is used).
51## The cgit repo on hjemli.net uses the the following command in it's 51## The cgit repo on hjemli.net uses the the following command in it's
52## post-receive hook to update the age-file: 52## post-receive hook to update the age-file:
53## git-for-each-ref --format="%(committerdate)" --sort=-committerdate \ 53## git-for-each-ref --format="%(committerdate)" --sort=-committerdate \
54## --count=1 > $GIT_DIR/info/web/last-modifie 54## --count=1 > $GIT_DIR/info/web/last-modifie
55## 55##
56#agefile=info/web/last-modified 56#agefile=info/web/last-modified
57 57
58 58
59## Git detects renames, but with a limit on the number of files to 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 60## consider. This option can be used to specify another limit (or -1 to
61## use the default limit). 61## use the default limit).
62## 62##
63#renamelimit=-1 63#renamelimit=-1
64 64
65 65
66## Specify a root for virtual urls. This makes cgit generate urls like 66## Specify a root for virtual urls. This makes cgit generate urls like
67## 67##
68## http://localhost/git/repo/log/?h=branch 68## http://localhost/git/repo/log/?h=branch
69## 69##
70## instead of 70## instead of
71## 71##
72## http://localhost/cgit/cgit.cgi?url=repo/log&h=branch 72## http://localhost/cgit/cgit.cgi?url=repo/log&h=branch
73## 73##
74## For this to work with apache, a rewrite rule must be added to httpd.conf, 74## For this to work with apache, a rewrite rule must be added to httpd.conf,
75## possibly looking something like this: 75## possibly looking something like this:
76## 76##
77## RewriteRule ^/git/(.*)$ /cgit/cgit.cgi?url=$1 [L,QSA] 77## RewriteRule ^/git/(.*)$ /cgit/cgit.cgi?url=$1 [L,QSA]
78## 78##
79## For this to work with lighttpd, the rewrite rule should look more like this: 79## For this to work with lighttpd, the rewrite rule should look more like this:
80## 80##
81## url.rewrite = ( 81## url.rewrite = (
82## "^/git/([^?/]+/[^?]*)?(?:\?(.*))?$" => "/cgit.cgi?url=$1&$2" 82## "^/git/([^?/]+/[^?]*)?(?:\?(.*))?$" => "/cgit.cgi?url=$1&$2"
83## ) 83## )
84## 84##
85## This setting is disabled by default. 85## This setting is disabled by default.
86#virtual-root=/git 86#virtual-root=/git
87 87
88 88
89## Set the title printed on the root page 89## Set the title printed on the root page
90#root-title=Git repository browser 90#root-title=Git repository browser
91 91
92 92
93## Set the description printed on the root page 93## Set the description printed on the root page
94#root-desc=a fast web interface for the git dscm 94#root-desc=a fast web interface for the git dscm
95 95
96 96
97## If specified, the file at this path will be included as HTML in the 97## If specified, the file at this path will be included as HTML in the
98## sidebar on the repository index page 98## sidebar on the repository index page
99#index-info= 99#index-info=
100 100
101 101
102## If specified, the file at this path will be included as HTML above 102## If specified, the file at this path will be included as HTML above
103## the repository index 103## the repository index
104#index-header= 104#index-header=
105 105
106 106
107## Link to css file 107## Link to css file
108#css=/cgit/cgit.css 108#css=/cgit/cgit.css
109 109
110## Link to favicon
111#favicon=/favicon.ico
110 112
111## Link to logo file 113## Link to logo file
112#logo=/cgit/git-logo.png 114#logo=/cgit/git-logo.png
113 115
114 116
115## Url loaded when clicking the logo 117## Url loaded when clicking the logo
116#logo-link=http://www.kernel.org/pub/software/scm/git/docs/ 118#logo-link=http://www.kernel.org/pub/software/scm/git/docs/
117 119
118 120
119## Url loaded when clicking a submodule link 121## Url loaded when clicking a submodule link
120#module-link=./?repo=%s&page=commit&id=%s 122#module-link=./?repo=%s&page=commit&id=%s
121 123
122 124
123## Shared prefix which, when combined with repo url, becomes the url used 125## Shared prefix which, when combined with repo url, becomes the url used
124## to clone the repo 126## to clone the repo
125#clone-prefix= 127#clone-prefix=
126 128
127 129
128## Number of chars shown of repo description (in repolist view) 130## Number of chars shown of repo description (in repolist view)
129#max-repodesc-length=60 131#max-repodesc-length=60
130 132
131 133
132## Number of chars shown of commit subject message (in log view) 134## Number of chars shown of commit subject message (in log view)
133#max-message-length=60 135#max-message-length=60
134 136
135 137
136## Number of commits per page in log view 138## Number of commits per page in log view
137#max-commit-count=50 139#max-commit-count=50
138 140
139 141
140## Root of cached output 142## Root of cached output
141#cache-root=/var/cache/cgit 143#cache-root=/var/cache/cgit
142 144
143 145
144## Include another config-file 146## Include another config-file
145#include=/var/cgit/repolist 147#include=/var/cgit/repolist
146 148
147## 149##
148## Time-To-Live settings: specifies how long (in minutes) different pages 150## Time-To-Live settings: specifies how long (in minutes) different pages
149## should be cached (0 for instant expiration, -1 for immortal pages) 151## should be cached (0 for instant expiration, -1 for immortal pages)
150## 152##
151 153
152## ttl for root page 154## ttl for root page
153#cache-root-ttl=5 155#cache-root-ttl=5
154 156
155## ttl for repo summary page 157## ttl for repo summary page
156#cache-repo-ttl=5 158#cache-repo-ttl=5
157 159
158## ttl for other dynamic pages 160## ttl for other dynamic pages
159#cache-dynamic-ttl=5 161#cache-dynamic-ttl=5
160 162
161## ttl for static pages (addressed by SHA-1) 163## ttl for static pages (addressed by SHA-1)
162#cache-static-ttl=-1 164#cache-static-ttl=-1
163 165
164 166
165 167
166## Example repository entry. Required values are repo.url and repo.path (each 168## Example repository entry. Required values are repo.url and repo.path (each
167## repository section must start with repo.url). 169## repository section must start with repo.url).
168#repo.url=cgit 170#repo.url=cgit
169#repo.name=cgit 171#repo.name=cgit
170#repo.desc=the caching cgi for git 172#repo.desc=the caching cgi for git
171 #repo.path=/pub/git/cgit ## this is the path to $GIT_DIR 173 #repo.path=/pub/git/cgit ## this is the path to $GIT_DIR
172#repo.owner=Lars Hjemli 174#repo.owner=Lars Hjemli
173 #repo.defbranch=master ## define a default branch 175 #repo.defbranch=master ## define a default branch
174 #repo.snapshots=tar.bz2 ## override a sitewide snapshot-setting 176 #repo.snapshots=tar.bz2 ## override a sitewide snapshot-setting
175 #repo.enable-log-filecount=0 ## override the default filecount setting 177 #repo.enable-log-filecount=0 ## override the default filecount setting
176 #repo.enable-log-linecount=0 ## override the default linecount setting 178 #repo.enable-log-linecount=0 ## override the default linecount setting
177 #repo.module-link=/git/%s/commit/?id=%s ## override the standard module-link 179 #repo.module-link=/git/%s/commit/?id=%s ## override the standard module-link
178 #repo.readme=info/web/readme ## specify a file to include on summary page 180 #repo.readme=info/web/readme ## specify a file to include on summary page
179#repo.clone-url=git://hjemli.net/pub/git/cgit 181#repo.clone-url=git://hjemli.net/pub/git/cgit
180 182
181## Additional repositories grouped under "mirrors" 183## Additional repositories grouped under "mirrors"
182#repo.group=mirrors 184#repo.group=mirrors
183 185
184#repo.url=git 186#repo.url=git
185#repo.path=/pub/git/git 187#repo.path=/pub/git/git
186#repo.clone-url=git://hjemli.net/pub/git/git 188#repo.clone-url=git://hjemli.net/pub/git/git
187# 189#
188#repo.url=linux 190#repo.url=linux
189#repo.path=/pub/git/linux 191#repo.path=/pub/git/linux
190 192
191## A group of private repositories (with a working directory) 193## A group of private repositories (with a working directory)
192#repo.group=private 194#repo.group=private
193 195
194#repo.url=larsh/cgit 196#repo.url=larsh/cgit
195#repo.path=/home/larsh/src/cgit/.git 197#repo.path=/home/larsh/src/cgit/.git
196 198
197#repo.url=larsh/git 199#repo.url=larsh/git
198#repo.path=/home/larsh/src/git/.git 200#repo.path=/home/larsh/src/git/.git