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