about summary refs log tree commit diff stats
path: root/cgitrc
diff options
context:
space:
mode:
authorLars Hjemli2008-10-05 18:55:49 +0200
committerLars Hjemli2008-10-05 18:55:49 +0200
commitdf46123b0e55027bc39403df285851d37f25a473 (patch)
tree0aa2dcc29d332e7bf5153405552d483d9a3c3d68 /cgitrc
parentMerge branch 'lh/escape-urls' (diff)
downloadcgit-df46123b0e55027bc39403df285851d37f25a473.tar.gz
cgit-df46123b0e55027bc39403df285851d37f25a473.zip
Replace cgitrc with cgitrc.5.txt
The new file describes all cgitrc options in a more structured manner then
the cgitrc example file and it might also work as the source for a cgitrc
man page.

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