summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChris Pickel <sfiera@macports.org>2007-09-08 19:37:43 -0400
committerLars Hjemli <hjemli@gmail.com>2007-09-09 09:53:59 +0200
commit0602d8c4f0b6752c59fd417364b26ed9447f3743 (patch)
treeef304065dd287251d07636463ac8f106c752c230
parent4beecc9a1873a603cd9b438e317ca385c79af92d (diff)
downloadcgit-0602d8c4f0b6752c59fd417364b26ed9447f3743.tar.gz
cgit-0602d8c4f0b6752c59fd417364b26ed9447f3743.tar.bz2
Improve the sample cgitrc file
Added and documented missing cgitrc parameters, improved documentation for virtual-root, added examples for repositories with a working directory. [lh:sligthly modified/extended] Signed-off-by: Lars Hjemli <hjemli@gmail.com>
-rw-r--r--cgitrc63
1 files changed, 51 insertions, 12 deletions
diff --git a/cgitrc b/cgitrc
index 1040997..bd180b4 100644
--- a/cgitrc
+++ b/cgitrc
@@ -30,20 +30,35 @@
#summary-log=0
+## The "Idle" column on the repository index page can read a timestamp
+## from the specified agefile (if this file cannot be found, the mtime
+## of HEAD is used).
+## The cgit repo on hjemli.net uses the the following command in it's
+## post-receive hook to update the age-file:
+## git-for-each-ref --format="%(committerdate)" --sort=-committerdate \
+## --count=1 > $GIT_DIR/info/web/last-modifie
+##
+#agefile=info/web/last-modified
+
+
## Specify a root for virtual urls. This makes cgit generate urls like
##
-## http://localhost/git/repo/log/?id=master
+## http://localhost/git/repo/log/?h=branch
##
## instead of
##
-## http://localhost/cgit/cgit.cgi?r=repo&p=log&id=master
+## http://localhost/cgit/cgit.cgi?url=repo/log&h=branch
##
-## For this to work with apache, rewrite rules must be added to httpd.conf,
+## For this to work with apache, a rewrite rule must be added to httpd.conf,
## possibly looking something like this:
##
-## RewriteRule ^/git/$ /cgit/cgit.cgi [L,QSA]
-## RewriteRule ^/git/([^/]+)/$ /cgit/cgit.cgi?r=$1 [L,QSA]
-## RewriteRule ^/git/([^/]+)/([^/]+)/$ /cgit/cgit.cgi?r=$1&p=$2 [L,QSA]
+## RewriteRule ^/git/(.*)$ /cgit/cgit.cgi?url=$1 [L,QSA]
+##
+## For this to work with lighttpd, the rewrite rule should look more like this:
+##
+## url.rewrite = (
+## "^/git/([^?/]+/[^?]*)?(?:\?(.*))?$" => "/cgit.cgi?url=$1&$2"
+## )
##
## This setting is disabled by default.
#virtual-root=/git
@@ -53,6 +68,11 @@
#root-title=Git repository browser
+## If specified, the file at this path will be included as HTML in the index
+## of repositories
+#index-header=
+
+
## Link to css file
#css=/cgit/cgit.css
@@ -112,10 +132,29 @@
#repo.url=cgit
#repo.name=cgit
#repo.desc=the caching cgi for git
-#repo.path=/pub/git/cgit
+#repo.path=/pub/git/cgit ## this is the path to $GIR_DIR
#repo.owner=Lars Hjemli
-#repo.snapshots=tar.bz2 # override a sitewide snapshot-setting
-#repo.enable-log-filecount=0 # override the default filecount setting
-#repo.enable-log-linecount=0 # override the default linecount setting
-#repo.module-link=/git/%s/commit/?id=%s # override the standard module-link
-#repo.readme=info/web/readme # specify a file to include on summary page
+#repo.defbranch=master ## define a default branch
+#repo.snapshots=tar.bz2 ## override a sitewide snapshot-setting
+#repo.enable-log-filecount=0 ## override the default filecount setting
+#repo.enable-log-linecount=0 ## override the default linecount setting
+#repo.module-link=/git/%s/commit/?id=%s ## override the standard module-link
+#repo.readme=info/web/readme ## specify a file to include on summary page
+
+## Additional repositories grouped under "mirrors"
+#repo.group=mirrors
+
+#repo.url=git
+#repo.path=/pub/git/git
+#
+#repo.url=linux
+#repo.path=/pub/git/linux
+
+## A group of private repositories (with a working directory)
+#repo.group=private
+
+#repo.url=larsh/cgit
+#repo.path=/home/larsh/src/cgit/.git
+
+#repo.url=larsh/git
+#repo.path=/home/larsh/src/git/.git