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 ## 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
  48 ## The "Idle" column on the repository index page can read a timestamp
  49 ## from the specified agefile (if this file cannot be found, the mtime
  50 ## of HEAD is used).
  51 ## The cgit repo on hjemli.net uses the the following command in it's
  52 ## post-receive hook to update the age-file:
  53 ##   git-for-each-ref --format="%(committerdate)" --sort=-committerdate \
  54 ##     --count=1 > $GIT_DIR/info/web/last-modifie
  55 ##
  56 #agefile=info/web/last-modified
  57
  58
  59 ## Git detects renames, but with a limit on the number of files to
  60 ## consider. This option can be used to specify another limit (or -1 to
  61 ## use the default limit).
  62 ##
  63 #renamelimit=-1
  64
  65
  66 ## Specify a root for virtual urls. This makes cgit generate urls like
  67 ##
  68 ##    http://localhost/git/repo/log/?h=branch
  69 ##
  70 ## instead of
  71 ##
  72 ##    http://localhost/cgit/cgit.cgi?url=repo/log&h=branch
  73 ##
  74 ## For this to work with apache, a rewrite rule must be added to httpd.conf,
  75 ## possibly looking something like this:
  76 ##
  77 ##    RewriteRule ^/git/(.*)$ /cgit/cgit.cgi?url=$1   [L,QSA]
  78 ##
  79 ## For this to work with lighttpd, the rewrite rule should look more like this:
  80 ##
  81 ##    url.rewrite = (
  82 ##        "^/git/([^?/]+/[^?]*)?(?:\?(.*))?$" => "/cgit.cgi?url=$1&$2"
  83 ##    )
  84 ##
  85 ## This setting is disabled by default.
  86 #virtual-root=/git
  87
  88
  89 ## Set the title printed on the root page
  90 #root-title=Git repository browser
  91
  92
  93 ## Set the description printed on the root page
  94 #root-desc=a fast web interface for the git dscm
  95
  96
  97 ## If specified, the file at this path will be included as HTML in the
  98 ## sidebar on the repository index page
  99 #index-info=
 100
 101
 102 ## If specified, the file at this path will be included as HTML above
 103 ## the repository index
 104 #index-header=
 105
 106
 107 ## Link to css file
 108 #css=/cgit/cgit.css
 109
 110
 111 ## Link to logo file
 112 #logo=/cgit/git-logo.png
 113
 114
 115 ## Url loaded when clicking the logo
 116 #logo-link=http://www.kernel.org/pub/software/scm/git/docs/
 117
 118
 119 ## Url loaded when clicking a submodule link
 120 #module-link=./?repo=%s&page=commit&id=%s
 121
 122
 123 ## Shared prefix which, when combined with repo url, becomes the url used
 124 ## to clone the repo
 125 #clone-prefix=
 126
 127
 128 ## Number of chars shown of repo description (in repolist view)
 129 #max-repodesc-length=60
 130
 131
 132 ## Number of chars shown of commit subject message (in log view)
 133 #max-message-length=60
 134
 135
 136 ## Number of commits per page in log view
 137 #max-commit-count=50
 138
 139
 140 ## Root of cached output
 141 #cache-root=/var/cache/cgit
 142
 143
 144 ## Include another config-file
 145 #include=/var/cgit/repolist
 146
 147 ##
 148 ## Time-To-Live settings: specifies how long (in minutes) different pages
 149 ## should be cached (0 for instant expiration, -1 for immortal pages)
 150 ##
 151
 152 ## ttl for root page
 153 #cache-root-ttl=5
 154
 155 ## ttl for repo summary page
 156 #cache-repo-ttl=5
 157
 158 ## ttl for other dynamic pages
 159 #cache-dynamic-ttl=5
 160
 161 ## ttl for static pages (addressed by SHA-1)
 162 #cache-static-ttl=-1
 163
 164
 165
 166 ## Example repository entry. Required values are repo.url and repo.path (each
 167 ## repository section must start with repo.url).
 168 #repo.url=cgit
 169 #repo.name=cgit
 170 #repo.desc=the caching cgi for git
 171 #repo.path=/pub/git/cgit                        ## this is the path to $GIT_DIR
 172 #repo.owner=Lars Hjemli
 173 #repo.defbranch=master                          ## define a default branch
 174 #repo.snapshots=tar.bz2                         ## override a sitewide snapshot-setting
 175 #repo.enable-log-filecount=0                    ## override the default filecount setting
 176 #repo.enable-log-linecount=0                    ## override the default linecount setting
 177 #repo.module-link=/git/%s/commit/?id=%s         ## override the standard module-link
 178 #repo.readme=info/web/readme                    ## specify a file to include on summary page
 179 #repo.clone-url=git://hjemli.net/pub/git/cgit
 180
 181 ## Additional repositories grouped under "mirrors"
 182 #repo.group=mirrors
 183
 184 #repo.url=git
 185 #repo.path=/pub/git/git
 186 #repo.clone-url=git://hjemli.net/pub/git/git
 187 #
 188 #repo.url=linux
 189 #repo.path=/pub/git/linux
 190
 191 ## A group of private repositories (with a working directory)
 192 #repo.group=private
 193
 194 #repo.url=larsh/cgit
 195 #repo.path=/home/larsh/src/cgit/.git
 196
 197 #repo.url=larsh/git
 198 #repo.path=/home/larsh/src/git/.git