cgitrc

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