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