diff options
Diffstat (limited to 'cgitrc.5.txt')
-rw-r--r-- | cgitrc.5.txt | 58 |
1 files changed, 55 insertions, 3 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt index 0c13485..c643fae 100644 --- a/cgitrc.5.txt +++ b/cgitrc.5.txt | |||
@@ -95,6 +95,11 @@ enable-filter-overrides:: | |||
95 | Flag which, when set to "1", allows all filter settings to be | 95 | Flag which, when set to "1", allows all filter settings to be |
96 | overridden in repository-specific cgitrc files. Default value: none. | 96 | overridden in repository-specific cgitrc files. Default value: none. |
97 | 97 | ||
98 | enable-gitweb-owner:: | ||
99 | If set to "1" and scan-path is enabled, we first check each repository | ||
100 | for the git config value "gitweb.owner" to determine the owner. | ||
101 | Default value: "1". See also: scan-path. | ||
102 | |||
98 | enable-index-links:: | 103 | enable-index-links:: |
99 | Flag which, when set to "1", will make cgit generate extra links for | 104 | Flag which, when set to "1", will make cgit generate extra links for |
100 | each repo in the repository index (specifically, to the "summary", | 105 | each repo in the repository index (specifically, to the "summary", |
@@ -110,6 +115,17 @@ enable-log-linecount:: | |||
110 | and removed lines for each commit on the repository log page. Default | 115 | and removed lines for each commit on the repository log page. Default |
111 | value: "0". | 116 | value: "0". |
112 | 117 | ||
118 | enable-remote-branches:: | ||
119 | Flag which, when set to "1", will make cgit display remote branches | ||
120 | in the summary and refs views. Default value: "0". See also: | ||
121 | "repo.enable-remote-branches". | ||
122 | |||
123 | enable-subject-links:: | ||
124 | Flag which, when set to "1", will make cgit use the subject of the | ||
125 | parent commit as link text when generating links to parent commits | ||
126 | in commit view. Default value: "0". See also: | ||
127 | "repo.enable-subject-links". | ||
128 | |||
113 | enable-tree-linenumbers:: | 129 | enable-tree-linenumbers:: |
114 | Flag which, when set to "1", will make cgit generate linenumber links | 130 | Flag which, when set to "1", will make cgit generate linenumber links |
115 | for plaintext blobs printed in the tree view. Default value: "1". | 131 | for plaintext blobs printed in the tree view. Default value: "1". |
@@ -161,6 +177,10 @@ logo-link:: | |||
161 | calculated url of the repository index page will be used. Default | 177 | calculated url of the repository index page will be used. Default |
162 | value: none. | 178 | value: none. |
163 | 179 | ||
180 | max-atom-items:: | ||
181 | Specifies the number of items to display in atom feeds view. Default | ||
182 | value: "10". | ||
183 | |||
164 | max-commit-count:: | 184 | max-commit-count:: |
165 | Specifies the number of entries to list per page in "log" view. Default | 185 | Specifies the number of entries to list per page in "log" view. Default |
166 | value: "50". | 186 | value: "50". |
@@ -177,6 +197,10 @@ max-repodesc-length:: | |||
177 | Specifies the maximum number of repo description characters to display | 197 | Specifies the maximum number of repo description characters to display |
178 | on the repository index page. Default value: "80". | 198 | on the repository index page. Default value: "80". |
179 | 199 | ||
200 | max-blob-size:: | ||
201 | Specifies the maximum size of a blob to display HTML for in KBytes. | ||
202 | Default value: "0" (limit disabled). | ||
203 | |||
180 | max-stats:: | 204 | max-stats:: |
181 | Set the default maximum statistics period. Valid values are "week", | 205 | Set the default maximum statistics period. Valid values are "week", |
182 | "month", "quarter" and "year". If unspecified, statistics are | 206 | "month", "quarter" and "year". If unspecified, statistics are |
@@ -205,6 +229,16 @@ noheader:: | |||
205 | Flag which, when set to "1", will make cgit omit the standard header | 229 | Flag which, when set to "1", will make cgit omit the standard header |
206 | on all pages. Default value: none. See also: "embedded". | 230 | on all pages. Default value: none. See also: "embedded". |
207 | 231 | ||
232 | project-list:: | ||
233 | A list of subdirectories inside of scan-path, relative to it, that | ||
234 | should loaded as git repositories. This must be defined prior to | ||
235 | scan-path. Default value: none. See also: scan-path. | ||
236 | |||
237 | remove-suffix:: | ||
238 | If set to "1" and scan-path is enabled, if any repositories are found | ||
239 | with a suffix of ".git", this suffix will be removed for the url and | ||
240 | name. Default value: "0". See also: scan-path. | ||
241 | |||
208 | renamelimit:: | 242 | renamelimit:: |
209 | Maximum number of files to consider when detecting renames. The value | 243 | Maximum number of files to consider when detecting renames. The value |
210 | "-1" uses the compiletime value in git (for further info, look at | 244 | "-1" uses the compiletime value in git (for further info, look at |
@@ -234,13 +268,20 @@ root-title:: | |||
234 | scan-path:: | 268 | scan-path:: |
235 | A path which will be scanned for repositories. If caching is enabled, | 269 | A path which will be scanned for repositories. If caching is enabled, |
236 | the result will be cached as a cgitrc include-file in the cache | 270 | the result will be cached as a cgitrc include-file in the cache |
237 | directory. Default value: none. See also: cache-scanrc-ttl. | 271 | directory. If project-list has been defined prior to scan-path, |
272 | scan-path loads only the directories listed in the file pointed to by | ||
273 | project-list. Default value: none. See also: cache-scanrc-ttl, | ||
274 | project-list. | ||
238 | 275 | ||
239 | section:: | 276 | section:: |
240 | The name of the current repository section - all repositories defined | 277 | The name of the current repository section - all repositories defined |
241 | after this option will inherit the current section name. Default value: | 278 | after this option will inherit the current section name. Default value: |
242 | none. | 279 | none. |
243 | 280 | ||
281 | side-by-side-diffs:: | ||
282 | If set to "1" shows side-by-side diffs instead of unidiffs per | ||
283 | default. Default value: "0". | ||
284 | |||
244 | snapshots:: | 285 | snapshots:: |
245 | Text which specifies the default set of snapshot formats generated by | 286 | Text which specifies the default set of snapshot formats generated by |
246 | cgit. The value is a space-separated list of zero or more of the | 287 | cgit. The value is a space-separated list of zero or more of the |
@@ -304,6 +345,14 @@ repo.enable-log-linecount:: | |||
304 | A flag which can be used to disable the global setting | 345 | A flag which can be used to disable the global setting |
305 | `enable-log-linecount'. Default value: none. | 346 | `enable-log-linecount'. Default value: none. |
306 | 347 | ||
348 | repo.enable-remote-branches:: | ||
349 | Flag which, when set to "1", will make cgit display remote branches | ||
350 | in the summary and refs views. Default value: <enable-remote-branches>. | ||
351 | |||
352 | repo.enable-subject-links:: | ||
353 | A flag which can be used to override the global setting | ||
354 | `enable-subject-links'. Default value: none. | ||
355 | |||
307 | repo.max-stats:: | 356 | repo.max-stats:: |
308 | Override the default maximum statistics period. Valid values are equal | 357 | Override the default maximum statistics period. Valid values are equal |
309 | to the values specified for the global "max-stats" setting. Default | 358 | to the values specified for the global "max-stats" setting. Default |
@@ -322,7 +371,9 @@ repo.path:: | |||
322 | 371 | ||
323 | repo.readme:: | 372 | repo.readme:: |
324 | A path (relative to <repo.path>) which specifies a file to include | 373 | A path (relative to <repo.path>) which specifies a file to include |
325 | verbatim as the "About" page for this repo. Default value: none. | 374 | verbatim as the "About" page for this repo. You may also specify a |
375 | git refspec by head or by hash by prepending the refspec followed by | ||
376 | a colon. For example, "master:docs/readme.mkd" Default value: none. | ||
326 | 377 | ||
327 | repo.snapshots:: | 378 | repo.snapshots:: |
328 | A mask of allowed snapshot-formats for this repo, restricted by the | 379 | A mask of allowed snapshot-formats for this repo, restricted by the |
@@ -413,7 +464,7 @@ snapshots=tar.gz tar.bz2 zip | |||
413 | ## List of common mimetypes | 464 | ## List of common mimetypes |
414 | ## | 465 | ## |
415 | 466 | ||
416 | mimetype.git=image/git | 467 | mimetype.gif=image/gif |
417 | mimetype.html=text/html | 468 | mimetype.html=text/html |
418 | mimetype.jpg=image/jpeg | 469 | mimetype.jpg=image/jpeg |
419 | mimetype.jpeg=image/jpeg | 470 | mimetype.jpeg=image/jpeg |
@@ -499,3 +550,4 @@ will generate the following html element: | |||
499 | AUTHOR | 550 | AUTHOR |
500 | ------ | 551 | ------ |
501 | Lars Hjemli <hjemli@gmail.com> | 552 | Lars Hjemli <hjemli@gmail.com> |
553 | Jason A. Donenfeld <Jason@zx2c4.com> | ||