summaryrefslogtreecommitdiffabout
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--cgitrc.5.txt10
1 files changed, 5 insertions, 5 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt
index ce78d41..ea1b18a 100644
--- a/cgitrc.5.txt
+++ b/cgitrc.5.txt
@@ -379,176 +379,176 @@ repo.path::
379 An absolute path to the repository directory. For non-bare repositories 379 An absolute path to the repository directory. For non-bare repositories
380 this is the .git-directory. Default value: none. 380 this is the .git-directory. Default value: none.
381 381
382repo.readme:: 382repo.readme::
383 A path (relative to <repo.path>) which specifies a file to include 383 A path (relative to <repo.path>) which specifies a file to include
384 verbatim as the "About" page for this repo. You may also specify a 384 verbatim as the "About" page for this repo. You may also specify a
385 git refspec by head or by hash by prepending the refspec followed by 385 git refspec by head or by hash by prepending the refspec followed by
386 a colon. For example, "master:docs/readme.mkd" Default value: <readme>. 386 a colon. For example, "master:docs/readme.mkd" Default value: <readme>.
387 387
388repo.snapshots:: 388repo.snapshots::
389 A mask of allowed snapshot-formats for this repo, restricted by the 389 A mask of allowed snapshot-formats for this repo, restricted by the
390 "snapshots" global setting. Default value: <snapshots>. 390 "snapshots" global setting. Default value: <snapshots>.
391 391
392repo.section:: 392repo.section::
393 Override the current section name for this repository. Default value: 393 Override the current section name for this repository. Default value:
394 none. 394 none.
395 395
396repo.source-filter:: 396repo.source-filter::
397 Override the default source-filter. Default value: none. See also: 397 Override the default source-filter. Default value: none. See also:
398 "enable-filter-overrides". 398 "enable-filter-overrides".
399 399
400repo.url:: 400repo.url::
401 The relative url used to access the repository. This must be the first 401 The relative url used to access the repository. This must be the first
402 setting specified for each repo. Default value: none. 402 setting specified for each repo. Default value: none.
403 403
404 404
405REPOSITORY-SPECIFIC CGITRC FILE 405REPOSITORY-SPECIFIC CGITRC FILE
406------------------------------- 406-------------------------------
407When the option "scan-path" is used to auto-discover git repositories, cgit 407When the option "scan-path" is used to auto-discover git repositories, cgit
408will try to parse the file "cgitrc" within any found repository. Such a 408will try to parse the file "cgitrc" within any found repository. Such a
409repo-specific config file may contain any of the repo-specific options 409repo-specific config file may contain any of the repo-specific options
410described above, except "repo.url" and "repo.path". Additionally, the "filter" 410described above, except "repo.url" and "repo.path". Additionally, the "filter"
411options are only acknowledged in repo-specific config files when 411options are only acknowledged in repo-specific config files when
412"enable-filter-overrides" is set to "1". 412"enable-filter-overrides" is set to "1".
413 413
414Note: the "repo." prefix is dropped from the option names in repo-specific 414Note: the "repo." prefix is dropped from the option names in repo-specific
415config files, e.g. "repo.desc" becomes "desc". 415config files, e.g. "repo.desc" becomes "desc".
416 416
417 417
418EXAMPLE CGITRC FILE 418EXAMPLE CGITRC FILE
419------------------- 419-------------------
420 420
421.... 421....
422# Enable caching of up to 1000 output entriess 422# Enable caching of up to 1000 output entriess
423cache-size=1000 423cache-size=1000
424 424
425 425
426# Specify some default clone prefixes 426# Specify some default clone prefixes
427clone-prefix=git://foobar.com ssh://foobar.com/pub/git http://foobar.com/git 427clone-prefix=git://example.com ssh://example.com/pub/git http://example.com/git
428 428
429# Specify the css url 429# Specify the css url
430css=/css/cgit.css 430css=/css/cgit.css
431 431
432 432
433# Show extra links for each repository on the index page 433# Show extra links for each repository on the index page
434enable-index-links=1 434enable-index-links=1
435 435
436 436
437# Show number of affected files per commit on the log pages 437# Show number of affected files per commit on the log pages
438enable-log-filecount=1 438enable-log-filecount=1
439 439
440 440
441# Show number of added/removed lines per commit on the log pages 441# Show number of added/removed lines per commit on the log pages
442enable-log-linecount=1 442enable-log-linecount=1
443 443
444 444
445# Add a cgit favicon 445# Add a cgit favicon
446favicon=/favicon.ico 446favicon=/favicon.ico
447 447
448 448
449# Use a custom logo 449# Use a custom logo
450logo=/img/mylogo.png 450logo=/img/mylogo.png
451 451
452 452
453# Enable statistics per week, month and quarter 453# Enable statistics per week, month and quarter
454max-stats=quarter 454max-stats=quarter
455 455
456 456
457# Set the title and heading of the repository index page 457# Set the title and heading of the repository index page
458root-title=foobar.com git repositories 458root-title=example.com git repositories
459 459
460 460
461# Set a subheading for the repository index page 461# Set a subheading for the repository index page
462root-desc=tracking the foobar development 462root-desc=tracking the foobar development
463 463
464 464
465# Include some more info about foobar.com on the index page 465# Include some more info about example.com on the index page
466root-readme=/var/www/htdocs/about.html 466root-readme=/var/www/htdocs/about.html
467 467
468 468
469# Allow download of tar.gz, tar.bz2 and zip-files 469# Allow download of tar.gz, tar.bz2 and zip-files
470snapshots=tar.gz tar.bz2 zip 470snapshots=tar.gz tar.bz2 zip
471 471
472 472
473## 473##
474## List of common mimetypes 474## List of common mimetypes
475## 475##
476 476
477mimetype.gif=image/gif 477mimetype.gif=image/gif
478mimetype.html=text/html 478mimetype.html=text/html
479mimetype.jpg=image/jpeg 479mimetype.jpg=image/jpeg
480mimetype.jpeg=image/jpeg 480mimetype.jpeg=image/jpeg
481mimetype.pdf=application/pdf 481mimetype.pdf=application/pdf
482mimetype.png=image/png 482mimetype.png=image/png
483mimetype.svg=image/svg+xml 483mimetype.svg=image/svg+xml
484 484
485 485
486## 486##
487## List of repositories. 487## List of repositories.
488## PS: Any repositories listed when section is unset will not be 488## PS: Any repositories listed when section is unset will not be
489## displayed under a section heading 489## displayed under a section heading
490## PPS: This list could be kept in a different file (e.g. '/etc/cgitrepos') 490## PPS: This list could be kept in a different file (e.g. '/etc/cgitrepos')
491## and included like this: 491## and included like this:
492## include=/etc/cgitrepos 492## include=/etc/cgitrepos
493## 493##
494 494
495 495
496repo.url=foo 496repo.url=foo
497repo.path=/pub/git/foo.git 497repo.path=/pub/git/foo.git
498repo.desc=the master foo repository 498repo.desc=the master foo repository
499repo.owner=fooman@foobar.com 499repo.owner=fooman@example.com
500repo.readme=info/web/about.html 500repo.readme=info/web/about.html
501 501
502 502
503repo.url=bar 503repo.url=bar
504repo.path=/pub/git/bar.git 504repo.path=/pub/git/bar.git
505repo.desc=the bars for your foo 505repo.desc=the bars for your foo
506repo.owner=barman@foobar.com 506repo.owner=barman@example.com
507repo.readme=info/web/about.html 507repo.readme=info/web/about.html
508 508
509 509
510# The next repositories will be displayed under the 'extras' heading 510# The next repositories will be displayed under the 'extras' heading
511section=extras 511section=extras
512 512
513 513
514repo.url=baz 514repo.url=baz
515repo.path=/pub/git/baz.git 515repo.path=/pub/git/baz.git
516repo.desc=a set of extensions for bar users 516repo.desc=a set of extensions for bar users
517 517
518repo.url=wiz 518repo.url=wiz
519repo.path=/pub/git/wiz.git 519repo.path=/pub/git/wiz.git
520repo.desc=the wizard of foo 520repo.desc=the wizard of foo
521 521
522 522
523# Add some mirrored repositories 523# Add some mirrored repositories
524section=mirrors 524section=mirrors
525 525
526 526
527repo.url=git 527repo.url=git
528repo.path=/pub/git/git.git 528repo.path=/pub/git/git.git
529repo.desc=the dscm 529repo.desc=the dscm
530 530
531 531
532repo.url=linux 532repo.url=linux
533repo.path=/pub/git/linux.git 533repo.path=/pub/git/linux.git
534repo.desc=the kernel 534repo.desc=the kernel
535 535
536# Disable adhoc downloads of this repo 536# Disable adhoc downloads of this repo
537repo.snapshots=0 537repo.snapshots=0
538 538
539# Disable line-counts for this repo 539# Disable line-counts for this repo
540repo.enable-log-linecount=0 540repo.enable-log-linecount=0
541 541
542# Restrict the max statistics period for this repo 542# Restrict the max statistics period for this repo
543repo.max-stats=month 543repo.max-stats=month
544.... 544....
545 545
546 546
547BUGS 547BUGS
548---- 548----
549Comments currently cannot appear on the same line as a setting; the comment 549Comments currently cannot appear on the same line as a setting; the comment
550will be included as part of the value. E.g. this line: 550will be included as part of the value. E.g. this line:
551 551
552 robots=index # allow indexing 552 robots=index # allow indexing
553 553
554will generate the following html element: 554will generate the following html element: