From: Jamie Couture <[email protected]> - include basic example for gitolite big-config, and .gitolite.rc
Signed-off-by: Jamie Couture <[email protected]> --- cgitrc.5.txt | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 45 insertions(+), 0 deletions(-) diff --git a/cgitrc.5.txt b/cgitrc.5.txt index 4721c1e..2931db1 100644 --- a/cgitrc.5.txt +++ b/cgitrc.5.txt @@ -146,6 +146,13 @@ enable-tree-linenumbers:: Flag which, when set to "1", will make cgit generate linenumber links for plaintext blobs printed in the tree view. Default value: "1". +enable-git-config:: + Flag which, when set to "1", will allow cgit to use git config to set + any repo specific settings. Please read <<repo-settings>> to learn more + about which settings are possible to set. This option is used in + conjunction with "scan-path" to override repo settings. Please read + <<git-config>> to learn how to integrate with gitolite. + favicon:: Url used as link to a shortcut icon for cgit. If specified, it is suggested to use the value "/favicon.ico" since certain browsers will @@ -360,6 +367,7 @@ virtual-root:: NOTE: cgit has recently learned how to use PATH_INFO to achieve the same kind of virtual urls, so this option will probably be deprecated. +[[repo-settings]] REPOSITORY SETTINGS ------------------- repo.about-filter:: @@ -468,6 +476,43 @@ options are only acknowledged in repo-specific config files when Note: the "repo." prefix is dropped from the option names in repo-specific config files, e.g. "repo.desc" becomes "desc". +[[git-config]] +REPOSITORY-SPECIFIC GIT CONFIG +------------------------------ +When "scan-path" is used to auto-discover repositories, using +"enable-git-config" will enable cgit to look at git config to obtain repo +specific settings. This is best managed by gitolite's big-config. Please can +read more about http://sitaramc.github.com/gitolite/confother_.html[gitolite +repo specific commands here]. + +.Example gitolite.conf +...... +repo aproject + RW+ = bob + config repo.section = applications + config repo.defbranch = development + aproject "Bob McPerson <[email protected]>" = "Foo description" + +repo bproject + RW+ = bob + config repo.section = test + config repo.logo = /cgit-data/logo.png + bproject "Bob McPerson <[email protected]>" = "Bar description" +...... + +[NOTE] +Apache users: use an Alias to separate your assets. +...... +Alias /cgit-data /var/www/htdocs/cgit +...... + +[IMPORTANT] +Remember to edit *.gitolite.rc* and add the following. Like cgitrc, we're +looking for repo settings with prefix repo. +...... +$GL_GITCONFIG_KEYS = "repo\..*" +...... + FILTER API ---------- -- 1.7.6 _______________________________________________ cgit mailing list [email protected] http://hjemli.net/mailman/listinfo/cgit
