-rw-r--r-- | cgitrc.5.txt | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt index 5d77973..c643fae 100644 --- a/cgitrc.5.txt +++ b/cgitrc.5.txt | |||
@@ -278,193 +278,195 @@ section:: | |||
278 | after this option will inherit the current section name. Default value: | 278 | after this option will inherit the current section name. Default value: |
279 | none. | 279 | none. |
280 | 280 | ||
281 | side-by-side-diffs:: | 281 | side-by-side-diffs:: |
282 | If set to "1" shows side-by-side diffs instead of unidiffs per | 282 | If set to "1" shows side-by-side diffs instead of unidiffs per |
283 | default. Default value: "0". | 283 | default. Default value: "0". |
284 | 284 | ||
285 | snapshots:: | 285 | snapshots:: |
286 | Text which specifies the default set of snapshot formats generated by | 286 | Text which specifies the default set of snapshot formats generated by |
287 | 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 |
288 | values "tar", "tar.gz", "tar.bz2" and "zip". Default value: none. | 288 | values "tar", "tar.gz", "tar.bz2" and "zip". Default value: none. |
289 | 289 | ||
290 | source-filter:: | 290 | source-filter:: |
291 | Specifies a command which will be invoked to format plaintext blobs | 291 | Specifies a command which will be invoked to format plaintext blobs |
292 | in the tree view. The command will get the blob content on its STDIN | 292 | in the tree view. The command will get the blob content on its STDIN |
293 | and the name of the blob as its only command line argument. The STDOUT | 293 | and the name of the blob as its only command line argument. The STDOUT |
294 | from the command will be included verbatim as the blob contents, i.e. | 294 | from the command will be included verbatim as the blob contents, i.e. |
295 | this can be used to implement e.g. syntax highlighting. Default value: | 295 | this can be used to implement e.g. syntax highlighting. Default value: |
296 | none. | 296 | none. |
297 | 297 | ||
298 | summary-branches:: | 298 | summary-branches:: |
299 | Specifies the number of branches to display in the repository "summary" | 299 | Specifies the number of branches to display in the repository "summary" |
300 | view. Default value: "10". | 300 | view. Default value: "10". |
301 | 301 | ||
302 | summary-log:: | 302 | summary-log:: |
303 | Specifies the number of log entries to display in the repository | 303 | Specifies the number of log entries to display in the repository |
304 | "summary" view. Default value: "10". | 304 | "summary" view. Default value: "10". |
305 | 305 | ||
306 | summary-tags:: | 306 | summary-tags:: |
307 | Specifies the number of tags to display in the repository "summary" | 307 | Specifies the number of tags to display in the repository "summary" |
308 | view. Default value: "10". | 308 | view. Default value: "10". |
309 | 309 | ||
310 | virtual-root:: | 310 | virtual-root:: |
311 | Url which, if specified, will be used as root for all cgit links. It | 311 | Url which, if specified, will be used as root for all cgit links. It |
312 | will also cause cgit to generate 'virtual urls', i.e. urls like | 312 | will also cause cgit to generate 'virtual urls', i.e. urls like |
313 | '/cgit/tree/README' as opposed to '?r=cgit&p=tree&path=README'. Default | 313 | '/cgit/tree/README' as opposed to '?r=cgit&p=tree&path=README'. Default |
314 | value: none. | 314 | value: none. |
315 | NOTE: cgit has recently learned how to use PATH_INFO to achieve the | 315 | NOTE: cgit has recently learned how to use PATH_INFO to achieve the |
316 | same kind of virtual urls, so this option will probably be deprecated. | 316 | same kind of virtual urls, so this option will probably be deprecated. |
317 | 317 | ||
318 | REPOSITORY SETTINGS | 318 | REPOSITORY SETTINGS |
319 | ------------------- | 319 | ------------------- |
320 | repo.about-filter:: | 320 | repo.about-filter:: |
321 | Override the default about-filter. Default value: none. See also: | 321 | Override the default about-filter. Default value: none. See also: |
322 | "enable-filter-overrides". | 322 | "enable-filter-overrides". |
323 | 323 | ||
324 | repo.clone-url:: | 324 | repo.clone-url:: |
325 | A list of space-separated urls which can be used to clone this repo. | 325 | A list of space-separated urls which can be used to clone this repo. |
326 | Default value: none. | 326 | Default value: none. |
327 | 327 | ||
328 | repo.commit-filter:: | 328 | repo.commit-filter:: |
329 | Override the default commit-filter. Default value: none. See also: | 329 | Override the default commit-filter. Default value: none. See also: |
330 | "enable-filter-overrides". | 330 | "enable-filter-overrides". |
331 | 331 | ||
332 | repo.defbranch:: | 332 | repo.defbranch:: |
333 | The name of the default branch for this repository. If no such branch | 333 | The name of the default branch for this repository. If no such branch |
334 | exists in the repository, the first branch name (when sorted) is used | 334 | exists in the repository, the first branch name (when sorted) is used |
335 | as default instead. Default value: "master". | 335 | as default instead. Default value: "master". |
336 | 336 | ||
337 | repo.desc:: | 337 | repo.desc:: |
338 | The value to show as repository description. Default value: none. | 338 | The value to show as repository description. Default value: none. |
339 | 339 | ||
340 | repo.enable-log-filecount:: | 340 | repo.enable-log-filecount:: |
341 | A flag which can be used to disable the global setting | 341 | A flag which can be used to disable the global setting |
342 | `enable-log-filecount'. Default value: none. | 342 | `enable-log-filecount'. Default value: none. |
343 | 343 | ||
344 | repo.enable-log-linecount:: | 344 | repo.enable-log-linecount:: |
345 | A flag which can be used to disable the global setting | 345 | A flag which can be used to disable the global setting |
346 | `enable-log-linecount'. Default value: none. | 346 | `enable-log-linecount'. Default value: none. |
347 | 347 | ||
348 | repo.enable-remote-branches:: | 348 | repo.enable-remote-branches:: |
349 | Flag which, when set to "1", will make cgit display 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>. | 350 | in the summary and refs views. Default value: <enable-remote-branches>. |
351 | 351 | ||
352 | repo.enable-subject-links:: | 352 | repo.enable-subject-links:: |
353 | A flag which can be used to override the global setting | 353 | A flag which can be used to override the global setting |
354 | `enable-subject-links'. Default value: none. | 354 | `enable-subject-links'. Default value: none. |
355 | 355 | ||
356 | repo.max-stats:: | 356 | repo.max-stats:: |
357 | Override the default maximum statistics period. Valid values are equal | 357 | Override the default maximum statistics period. Valid values are equal |
358 | to the values specified for the global "max-stats" setting. Default | 358 | to the values specified for the global "max-stats" setting. Default |
359 | value: none. | 359 | value: none. |
360 | 360 | ||
361 | repo.name:: | 361 | repo.name:: |
362 | The value to show as repository name. Default value: <repo.url>. | 362 | The value to show as repository name. Default value: <repo.url>. |
363 | 363 | ||
364 | repo.owner:: | 364 | repo.owner:: |
365 | A value used to identify the owner of the repository. Default value: | 365 | A value used to identify the owner of the repository. Default value: |
366 | none. | 366 | none. |
367 | 367 | ||
368 | repo.path:: | 368 | repo.path:: |
369 | An absolute path to the repository directory. For non-bare repositories | 369 | An absolute path to the repository directory. For non-bare repositories |
370 | this is the .git-directory. Default value: none. | 370 | this is the .git-directory. Default value: none. |
371 | 371 | ||
372 | repo.readme:: | 372 | repo.readme:: |
373 | 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 |
374 | 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. | ||
375 | 377 | ||
376 | repo.snapshots:: | 378 | repo.snapshots:: |
377 | 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 |
378 | "snapshots" global setting. Default value: <snapshots>. | 380 | "snapshots" global setting. Default value: <snapshots>. |
379 | 381 | ||
380 | repo.section:: | 382 | repo.section:: |
381 | Override the current section name for this repository. Default value: | 383 | Override the current section name for this repository. Default value: |
382 | none. | 384 | none. |
383 | 385 | ||
384 | repo.source-filter:: | 386 | repo.source-filter:: |
385 | Override the default source-filter. Default value: none. See also: | 387 | Override the default source-filter. Default value: none. See also: |
386 | "enable-filter-overrides". | 388 | "enable-filter-overrides". |
387 | 389 | ||
388 | repo.url:: | 390 | repo.url:: |
389 | The relative url used to access the repository. This must be the first | 391 | The relative url used to access the repository. This must be the first |
390 | setting specified for each repo. Default value: none. | 392 | setting specified for each repo. Default value: none. |
391 | 393 | ||
392 | 394 | ||
393 | REPOSITORY-SPECIFIC CGITRC FILE | 395 | REPOSITORY-SPECIFIC CGITRC FILE |
394 | ------------------------------- | 396 | ------------------------------- |
395 | When the option "scan-path" is used to auto-discover git repositories, cgit | 397 | When the option "scan-path" is used to auto-discover git repositories, cgit |
396 | will try to parse the file "cgitrc" within any found repository. Such a | 398 | will try to parse the file "cgitrc" within any found repository. Such a |
397 | repo-specific config file may contain any of the repo-specific options | 399 | repo-specific config file may contain any of the repo-specific options |
398 | described above, except "repo.url" and "repo.path". Additionally, the "filter" | 400 | described above, except "repo.url" and "repo.path". Additionally, the "filter" |
399 | options are only acknowledged in repo-specific config files when | 401 | options are only acknowledged in repo-specific config files when |
400 | "enable-filter-overrides" is set to "1". | 402 | "enable-filter-overrides" is set to "1". |
401 | 403 | ||
402 | Note: the "repo." prefix is dropped from the option names in repo-specific | 404 | Note: the "repo." prefix is dropped from the option names in repo-specific |
403 | config files, e.g. "repo.desc" becomes "desc". | 405 | config files, e.g. "repo.desc" becomes "desc". |
404 | 406 | ||
405 | 407 | ||
406 | EXAMPLE CGITRC FILE | 408 | EXAMPLE CGITRC FILE |
407 | ------------------- | 409 | ------------------- |
408 | 410 | ||
409 | .... | 411 | .... |
410 | # Enable caching of up to 1000 output entriess | 412 | # Enable caching of up to 1000 output entriess |
411 | cache-size=1000 | 413 | cache-size=1000 |
412 | 414 | ||
413 | 415 | ||
414 | # Specify some default clone prefixes | 416 | # Specify some default clone prefixes |
415 | clone-prefix=git://foobar.com ssh://foobar.com/pub/git http://foobar.com/git | 417 | clone-prefix=git://foobar.com ssh://foobar.com/pub/git http://foobar.com/git |
416 | 418 | ||
417 | # Specify the css url | 419 | # Specify the css url |
418 | css=/css/cgit.css | 420 | css=/css/cgit.css |
419 | 421 | ||
420 | 422 | ||
421 | # Show extra links for each repository on the index page | 423 | # Show extra links for each repository on the index page |
422 | enable-index-links=1 | 424 | enable-index-links=1 |
423 | 425 | ||
424 | 426 | ||
425 | # Show number of affected files per commit on the log pages | 427 | # Show number of affected files per commit on the log pages |
426 | enable-log-filecount=1 | 428 | enable-log-filecount=1 |
427 | 429 | ||
428 | 430 | ||
429 | # Show number of added/removed lines per commit on the log pages | 431 | # Show number of added/removed lines per commit on the log pages |
430 | enable-log-linecount=1 | 432 | enable-log-linecount=1 |
431 | 433 | ||
432 | 434 | ||
433 | # Add a cgit favicon | 435 | # Add a cgit favicon |
434 | favicon=/favicon.ico | 436 | favicon=/favicon.ico |
435 | 437 | ||
436 | 438 | ||
437 | # Use a custom logo | 439 | # Use a custom logo |
438 | logo=/img/mylogo.png | 440 | logo=/img/mylogo.png |
439 | 441 | ||
440 | 442 | ||
441 | # Enable statistics per week, month and quarter | 443 | # Enable statistics per week, month and quarter |
442 | max-stats=quarter | 444 | max-stats=quarter |
443 | 445 | ||
444 | 446 | ||
445 | # Set the title and heading of the repository index page | 447 | # Set the title and heading of the repository index page |
446 | root-title=foobar.com git repositories | 448 | root-title=foobar.com git repositories |
447 | 449 | ||
448 | 450 | ||
449 | # Set a subheading for the repository index page | 451 | # Set a subheading for the repository index page |
450 | root-desc=tracking the foobar development | 452 | root-desc=tracking the foobar development |
451 | 453 | ||
452 | 454 | ||
453 | # Include some more info about foobar.com on the index page | 455 | # Include some more info about foobar.com on the index page |
454 | root-readme=/var/www/htdocs/about.html | 456 | root-readme=/var/www/htdocs/about.html |
455 | 457 | ||
456 | 458 | ||
457 | # Allow download of tar.gz, tar.bz2 and zip-files | 459 | # Allow download of tar.gz, tar.bz2 and zip-files |
458 | snapshots=tar.gz tar.bz2 zip | 460 | snapshots=tar.gz tar.bz2 zip |
459 | 461 | ||
460 | 462 | ||
461 | ## | 463 | ## |
462 | ## List of common mimetypes | 464 | ## List of common mimetypes |
463 | ## | 465 | ## |
464 | 466 | ||
465 | mimetype.gif=image/gif | 467 | mimetype.gif=image/gif |
466 | mimetype.html=text/html | 468 | mimetype.html=text/html |
467 | mimetype.jpg=image/jpeg | 469 | mimetype.jpg=image/jpeg |
468 | mimetype.jpeg=image/jpeg | 470 | mimetype.jpeg=image/jpeg |
469 | mimetype.pdf=application/pdf | 471 | mimetype.pdf=application/pdf |
470 | mimetype.png=image/png | 472 | mimetype.png=image/png |