cgit/cgitrc
Lars Hjemli ce1c7336e5 Read repo-info from /etc/cgitrc
This makes cgit read all repo-info from the configfile, instead of scanning for
possible git-dirs below a common root path. This is primarily done to get
better security (separate physical path from logical repo-name).

In /etc/cgitrc each repo is registered with the following keys:

repo.url
repo.name
repo.path
repo.desc
repo.owner

Note:

*Required keys are repo.url and repo.path, all others are optional
*Each occurrence of repo.url starts a new repository registration
*Default value for repo.name is taken from repo.url
*The value of repo.url cannot contain characters with special meaning for
 urls (i.e. one of /?%&), while repo.name can contain anything.

Example:

repo.url=cgit-pub
repo.name=cgit/public
repo.path=/pub/git/cgit
repo.desc=My public cgit repo
repo.owner=Lars Hjemli

repo.url=cgit-priv
repo.name=cgit/private
repo.path=/home/larsh/src/cgit/.git
repo.desc=My private cgit repo
repo.owner=Lars Hjemli

Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-02-04 21:47:46 +01:00

69 lines
1.4 KiB
Plaintext

##
## cgitrc: template for /etc/cgitrc
##
## base for virtual urls. If specified, rewrite rules must be added to
## httpd.conf. Possible rules for /git/ when cgit.cgi is accessed as /cgit.cgi:
##
## RewriteRule ^/git/$ /cgit.cgi [L,QSA]
## RewriteRule ^/git/([^/]+)/$ /cgit.cgi?r=$1 [L,QSA]
## RewriteRule ^/git/([^/]+)/([^/]+)/$ /cgit.cgi?r=$1&p=$2 [L,QSA]
##
#virtual-root=/git
## page title for the root page (repo listing)
#root-title=Git repository browser
## link to css file
#css=/cgit.css
## link to logo file
#logo=/git-logo.png
## url loaded when clicking the logo
#logo-link=http://www.kernel.org/pub/software/scm/git/docs/
## set number of initial chars to show of commit subject message in log views
#max-message-length=60
## Set to 1 to deactivate caching of generated pages
#nocache=0
## root path for cached output
#cache-root=/var/cache/cgit
##
## Time-To-Live settings: specify how long (in minutes) different pages should
## be cached. Specify 0 for instant expiration and -1 for immortal pages
##
## ttl for root page (repo listing)
#cache-root-ttl=5
## ttl for repo summary page
#cache-repo-ttl=5
## ttl for other dynamic pages
#cache-dynamic-ttl=5
## ttl for static pages (addressed by SHA-1)
#cache-static-ttl=-1
## Example repository entry
#repo.url=cgit
#repo.name=cgit
#repo.desc=the caching cgi for git
#repo.path=/pub/git/cgit
#repo.owner=Lars Hjemli