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