[BACK]Return to cvsweb.conf CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / cvsweb

Annotation of cvsweb/cvsweb.conf, Revision 3.13

3.1       knu         1: # -*-perl-*-
                      2: # Configuration of cvsweb.cgi, the
                      3: # CGI interface to CVS Repositories.
                      4: #
                      5: # (c) 1998-1999 H. Zeller    <zeller@think.de>
                      6: #     1999      H. Nordstrom <hno@hem.passagen.se>
                      7: #     2000      A. MUSHA     <knu@FreeBSD.org>
                      8: #          based on work by Bill Fenner  <fenner@FreeBSD.org>
3.6       knu         9: # $zId: cvsweb.conf,v 3.27 2000/07/27 10:16:39 kcoar Exp $
3.13    ! knu        10: # $Id: cvsweb.conf,v 3.12 2000/12/28 17:49:28 knu Exp $
3.1       knu        11: #
                     12: ###
                     13:
                     14: ##############
                     15: # CVS Root
                     16: ##############
                     17: # CVSweb can handle several CVS-Repositories
                     18: # at once. Enter a short symbolic names and the
                     19: # full path of these repositories here.
                     20: # NOTE that the symbolic names may not contain
                     21: # whitespaces.
                     22: # Note, that cvsweb.cgi currently needs to have physical access
                     23: # to the CVS repository so :pserver:someone@xyz.com:/data/cvsroot
                     24: # won't work!
                     25:
                     26: # 'symbolic_name' 'path_to_the_actual_repository'
                     27: %CVSROOT = (
                     28:            'local'     => '/home/cvs',
                     29:            'freebsd'   => '/home/ncvs',
                     30:           );
                     31:
                     32: %CVSROOTdescr = (
                     33:                 'local'     => 'Local Repository',
                     34:                 'freebsd'   => 'FreeBSD',
                     35:                );
                     36:
                     37: # This tree is enabled by default when
                     38: # you enter the page
                     39: $cvstreedefault = 'local';
                     40:
                     41: ##############
                     42: # PR categoties
                     43: ##############
                     44: @prcategories = qw(
                     45:                   advocacy
                     46:                   alpha
                     47:                   bin
                     48:                   conf
                     49:                   docs
                     50:                   gnu
                     51:                   i386
                     52:                   kern
                     53:                   misc
                     54:                   ports
                     55:                   sparc
                     56:                  );
                     57:
                     58: ##############
                     59: # query-pr.cgi
                     60: ##############
3.8       knu        61: $prcgi = "http://www.FreeBSD.org/cgi/query-pr.cgi?pr=%s";
                     62:
                     63: ##############
                     64: # man.cgi
                     65: ##############
                     66: $mancgi = "http://www.FreeBSD.org/cgi/man.cgi?apropos=0&sektion=%s&query=%s&manpath=FreeBSD+5.0-current&format=html";
3.1       knu        67:
                     68: ##############
                     69: # Defaults for UserSettings
                     70: ##############
                     71: %DEFAULTVALUE = (
                     72:       # sortby: File sort order
                     73:       #   file   Sort by filename
                     74:       #   rev    Sort by revision number
                     75:       #   date   Sort by commit date
                     76:       #   author Sort by author
                     77:       #   log    Sort by log message
                     78:
                     79:       "sortby" => "file",
                     80:
                     81:       # hideattic: Hide or show files in Attic
                     82:       #   1      Hide files in Attic
                     83:       #   0      Show files in Attic
                     84:
                     85:       "hideattic" => "1",
                     86:
                     87:       # logsort: Sort order for CVS logs
                     88:       #   date   Sort revisions by date
                     89:       #   rev    Sort revision by revision number
                     90:       #   cvs    Don't sort them. Same order as CVS/RCS shows them.
                     91:
                     92:       "logsort" => "date",
                     93:
                     94:       # f:      Default diff format
                     95:       #   h      Human readable
                     96:       #   u      Unified diff
                     97:       #   c      Context diff
                     98:       #   s      Side by side
3.10      knu        99:       "f" => "u",
3.1       knu       100:
                    101:       # hidecvsroot: Don't show the CVSROOT directory
                    102:       #   1      Hide CVSROOT directory
                    103:       #   0      Show CVSROOT directory
                    104:       "hidecvsroot" => "0",
                    105:
                    106:       # hidenonreadable: Don't show entries which cannot be read
                    107:       #   1      Hide non-readable entries
3.4       knu       108:       #   0      Show non-readable entries
3.1       knu       109:       "hidenonreadable" => "1",
                    110: );
                    111:
                    112: ##############
                    113: # some layout stuff
                    114: ##############
                    115:
3.9       knu       116: # The body-tag for directory views and logs
3.1       knu       117: $body_tag = '<body text="#000000" bgcolor="#ffffff">';
                    118:
3.9       knu       119: # The body-tag for diffs and annotations
                    120: $body_tag_for_src = '<body text="#000000" bgcolor="#eeeeee">';
                    121:
3.1       knu       122: # Wanna have a logo on the page ?
                    123: $logo = '<img src="/icons/apache_pb.gif">';
                    124:
                    125: # The title of the Page on startup
                    126: $defaulttitle = "CVS Repository";
                    127:
                    128: # The address is shown on the footer
3.2       knu       129: $address = "<font size=-1>CVSweb by &lt;knu\@FreeBSD.org&gt;</font>";
3.1       knu       130:
                    131: # color of navigation Header for
                    132: # diffs and annotations
                    133: $navigationHeaderColor = '#9999ee';
                    134:
                    135: $long_intro = <<EOT;
                    136: <p>
                    137: This is a WWW interface for CVS Repositories.
                    138: You can browse the file hierarchy by picking directories
                    139: (which have slashes after them, <i>e.g.</i>, <b>src/</b>).
                    140: If you pick a file, you will see the revision history
                    141: for that file.
                    142: Selecting a revision number will download that revision of
                    143: the file.  There is a link at each revision to display
                    144: diffs between that revision and the previous one, and
                    145: a form at the bottom of the page that allows you to
                    146: display diffs between arbitrary revisions.
                    147: </p>
                    148: <p>
                    149: This script has been written by Bill Fenner
3.5       knu       150: &lt;<a href="mailto:fenner\@FreeBSD.org">fenner\@FreeBSD.org</a>&gt;
3.1       knu       151: and improved by Henner Zeller
                    152: &lt;<a href="mailto:zeller\@think.de">zeller\@think.de</a>&gt;,
                    153: Henrik Nordstr&ouml;m
                    154: &lt;<a href="mailto:hno\@hem.passagen.se">hno\@hem.passagen.se</a>&gt;, and
                    155: Ken Coar
                    156: &lt;<a href="mailto:Ken.Coar\@Golux.Com">Ken.Coar\@Golux.Com</a>&gt;, then
                    157: Akinori MUSHA &lt;<a href="mailto:knu\@FreeBSD.org">knu\@FreeBSD.org</a>&gt;
                    158: brought it back to FreeBSD community and added more facilities;
                    159: it is covered by the
                    160: <a href="http://www.opensource.org/licenses/bsd-license.html">BSD-Licence</a>.
                    161: </p>
                    162: <p>
                    163: If you would like to use this CGI script on your own web server and
                    164: CVS tree, see Zeller's
                    165: <a href="http://linux.fh-heilbronn.de/~zeller/cgi/cvsweb.cgi"
                    166: >CVSweb distribution site</a>. Bill's original script can be found
3.5       knu       167: <a href="http://www.FreeBSD.org/~fenner/cvsweb/">here</a>.
3.1       knu       168: </p>
                    169: <p>
                    170: Please send any suggestions, comments, etc. to
3.5       knu       171: <a href="mailto:fenner\@FreeBSD.org">Bill Fenner</a> or, regarding the
3.1       knu       172: modifications, to
                    173: <a href="mailto:knu\@FreeBSD.org">Akinori MUSHA</a>,
                    174: <a href="mailto:zeller\@think.de">Henner Zeller</a>,
                    175: <a href="mailto:hno\@hem.passagen.se">Henrik Nordstr&ouml;m</a>, or
                    176: <a href="mailto:Ken.Coar\@Golux.Com">Ken Coar</a>.
                    177: </p>
                    178: EOT
                    179:
                    180: $short_instruction = <<EOT;
                    181: <p>
                    182: Click on a directory to enter that directory. Click on a file to display
                    183: its revision history and to get a chance to display diffs between revisions.
                    184: </p>
                    185: EOT
                    186:
                    187: # used icons; if icon-url is empty, the text representation is used; if
                    188: # you do not want to have an ugly tooltip for the icon, remove the
                    189: # text-representation.
                    190: # The width and height of the icon allow the browser to correcly display
                    191: # the table while still loading the icons.
                    192: # These default icons are coming with apache.
                    193: # If these icons are too large, check out the miniicons in the
                    194: # icons/ directory; they have a width/height of 16/16
                    195: # format:               TEXT      ICON-URL          width height
                    196: %ICONS  = (
                    197:           back => [ ("[BACK]", "/icons/cvsweb/back.gif", 20,   22) ],
                    198:           dir  => [ ("[DIR]",  "/icons/cvsweb/dir.gif",  20,   22) ],
                    199:           file => [ ("[TXT]",  "/icons/cvsweb/text.gif", 20,   22) ],
                    200:           );
                    201:
                    202: # the length to which the last logentry should
                    203: # be truncated when shown in the directory view
                    204: $shortLogLen = 80;
                    205:
                    206: # Show author of last change
                    207: $show_author = 1;
                    208:
                    209: ##############
                    210: # table view for directories
                    211: ##############
                    212:
                    213: # Show directory as table
                    214: # this is much more readable but has one
                    215: # drawback: the whole table has to be loaded
                    216: # before common browsers display it which may
                    217: # be annoying if you have a slow link - and a
                    218: # large directory ..
                    219: $dirtable = 1;
                    220:
                    221: # show different colors for even/odd rows
                    222: @tabcolors = ('#ffffff', '#ffffff');
                    223: $tablepadding = 2;
                    224:
                    225: # Color of Header
                    226: $columnHeaderColorDefault = '#ffffcc';
                    227: $columnHeaderColorSorted  = '#ffcc66';
                    228:
                    229: #
                    230: # If you want to have colored borders
                    231: # around each row, uncomment this
                    232: $tableBorderColor = '#cccccc';
                    233:
                    234: #
                    235: # Modules in the repository that should not be displayed, either by default
                    236: # nor by explicit path specification.
                    237: #
                    238: @HideModules = (
                    239:               );
                    240:
                    241: #
                    242: # Use CVSROOT/CVSROOT/descriptions for describing the directories/modules
                    243: # See INSTALL section 8
                    244: #
                    245: $use_descriptions = 0;
                    246:
                    247: ##############
                    248: # Human Readable Diff
                    249: ##############
                    250:
                    251: # (c) 1998 H. Zeller <zeller@think.de>
                    252: #
                    253: # Generates two columns of color encoded
                    254: # diff; much like xdiff or emacs-ediff mode.
                    255: #
                    256: # The diff-stuff is a piece of code I once made for
                    257: # cvs2html which is under GPL,
                    258: # see http://www.sslug.dk/cvs2html
                    259: # (c) 1997/98 Peter Toft <pto@sslug.imm.dtu.dk>
                    260: #
                    261: # some parameters to screw:
                    262: ##
                    263:
                    264: # make lines breakable so that the columns do not
                    265: # exceed the width of the browser
                    266: $hr_breakable = 1;
                    267:
3.4       knu       268: # give out function names in diffs
3.1       knu       269: # this just makes sense if we have C-files, otherwise
                    270: # diff's heuristic doesn't work well ..
                    271: # ( '-p' option to diff)
3.4       knu       272: $showfunc = 1;
3.1       knu       273:
                    274: # For each pair of regexps, files that match the first regexp will be diff'ed
                    275: # with an '-F' option with the second regexp.
3.4       knu       276: %funcline_regexp = (
                    277:                    "\\.(4th|fr)\$" => "\\(^\\| \\|\t\\): ",
                    278:                   );
3.1       knu       279:
                    280: # ignore whitespaces for human readable diffs
                    281: # (indendation and stuff ..)
                    282: # ( '-w' option to diff)
3.7       knu       283: $hr_ignwhite = 0;
3.1       knu       284:
                    285: # ignore diffs which are caused by
                    286: # keyword-substitution like $Id - Stuff
                    287: # ( '-kk' option to rcsdiff)
                    288: $hr_ignkeysubst = 1;
                    289:
                    290: # Colors and font to show the diff type of code changes
                    291: $diffcolorHeading    = '#99cccc';  # color of 'Line'-head of each diffed file
                    292: $diffcolorEmpty      = '#cccccc';  # color of 'empty' lines
                    293: $diffcolorRemove     = '#ff9999';  # Removed line(s) (left)  (  -  )
                    294: $diffcolorChange     = '#99ff99';  # Changed line(s) (     both    )
                    295: $diffcolorAdd        = '#ccccff';  # Added line(s)   (  - )  (right)
                    296: $diffcolorDarkChange = '#99cc99';  # lines, which are empty in change
                    297: $difffontface        = "Helvetica,Arial";
                    298: $difffontsize        = "-1";
                    299:
                    300: # the width of the textinput of the
                    301: # request-diff-form
                    302: $inputTextSize = 12;
                    303:
                    304: ##############
                    305: # Mime Types
                    306: ##############
                    307:
                    308: # mapping to mimetypes to help
                    309: # cvsweb to guess the correct mime-type on
                    310: # checkout; you can use the mime.types from
                    311: # apache here:
                    312: $mime_types = '/usr/local/etc/apache/mime.types';
                    313:
                    314: # quick mime-type lookup; maps file-suffices to
                    315: # mime-types for displaying checkouts in the browser.
                    316: # Further MimeTypes will be found in the
                    317: # file $mime_types (apache style mime.types - file)
                    318: # - add common mappings here for faster lookup
                    319: %MTYPES = (
                    320:           "html"  => "text/html",
                    321:           "shtml" => "text/html",
                    322:           "gif"   => "image/gif",
                    323:           "jpeg"  => "image/jpeg",
3.12      knu       324:           "jpg"   => "image/jpeg",
                    325:           "png"   => "image/png",
                    326:           "xpm"   => "image/xpm",
3.1       knu       327:           "*"     => "text/plain",
                    328:          );
3.11      knu       329:
                    330: # Charset for HTML output
3.13    ! knu       331: $charset = '';
        !           332: # e.g.
        !           333: #$charset = $where =~ m,/ru[/_-], ? 'koi8-r'
        !           334: #  : $where =~ m,/zh[/_-], ? 'big5'
        !           335: #  : $where =~ m,/ja[/_-], ? 'x-euc-jp'
        !           336: #  : $where =~ m,/ko[/_-], ? 'x-euc-kr'
        !           337: #  : 'iso-8859-1';
3.1       knu       338:
                    339: ##############
                    340: # Misc
                    341: ##############
                    342: # allow annotation of files
                    343: # this requires rw-access to the
3.12      knu       344: # CVSROOT/history file (if you have one)
                    345: # and rw-access to the subdirectory to
                    346: # place the lock so you maybe don't want it
3.1       knu       347: $allow_annotate = 1;
                    348:
                    349: # allow pretty-printed version of files
                    350: $allow_markup = 1;
                    351:
                    352: # allow compression with gzip
                    353: # of output if the Browser accepts
                    354: # it (HTTP_ACCEPT_ENCODING=gzip)
                    355: # [make sure to have gzip in the path]
                    356: $allow_compress = 1;
                    357:
                    358: # Make use of javascript functions.
                    359: # This way you can select one of your CVSroot
                    360: # without pressing 'Go' (.. if you do have more
                    361: # than one CVSROOT defined)
                    362: $use_java_script = 1;
                    363:
                    364: # open Download-Links in another window
                    365: $open_extern_window = 1;
                    366:
                    367: # The size of this extern window; this size option
                    368: # needs use_java_script to be defined
                    369: # just comment them if you don't want to have a fixed
                    370: # size
                    371: #$extern_window_width = 600;
                    372: #$extern_window_height = 440;
                    373:
                    374: # Edit Options
                    375: # Enable form to edit your options (hideattic,sortbydate)
                    376: # this isn't necessary if you've $dirtable defined 'cause
                    377: # this allows editing of all your options more intuitive
                    378: $edit_option_form = (not $dirtable);
                    379:
                    380: # remember to set the path to your
                    381: # rcsutils: rlog, rcsdiff (gzip if you use compression)
                    382: #$ENV{'PATH'} = '/usr/local/bin';
                    383:
                    384: # If you have files which automatically refers to other files
                    385: # (such as HTML) then this allows you to browse the checked
                    386: # out files as if outside CVS.
                    387: $checkout_magic = 1;
                    388:
                    389: # Show last changelog message for sub directories
                    390: # The current implementation makes many assumptions and may show the
                    391: # incorrect file at some times. The main assumption is that the last
                    392: # modified file has the newest filedate. But some CVS operations
                    393: # touches the file without even when a new version is't checked in,
                    394: # and TAG based browsing essientially puts this out of order, unless
                    395: # the last checkin was on the same tag as you are viewing.
                    396: # Enable this if you like the feature, but don't rely on correct results.
                    397: $show_subdir_lastmod = 0;
                    398:
                    399: # Background color of logentry in markup
                    400: $markupLogColor = "#ffffff";
                    401:
                    402: # Show CVS log when viewing file contents
                    403: $show_log_in_markup = 1;
                    404:
3.13    ! knu       405: # Preformat when viewing file contents.  This should be turned off
        !           406: # when you have files in the repository that are in a multibyte
        !           407: # encoding which uses HTML special characters ([<>&"]) as part of a
        !           408: # multi-byte character. (such as iso-2022-jp, ShiftJIS, etc.)
        !           409: # Otherwise those files will get screwed up in markup.
        !           410: $preformat_in_markup = '';
        !           411:
3.1       knu       412: # Tabstop used to expand tabs in colored diffs. If undefined then
                    413: # tabs are always expanded to 8 spaces.
                    414: $tabstop = 8;
                    415:
                    416: # if you wish to display absolute times in your local timezone,
                    417: # then define mytz and fill in the strings for your standard and
                    418: # daylight time. Note that you must also make sure the system
                    419: # timezone is correctly set.
                    420: # @mytz=("EST", "EDT");
                    421:
                    422: # cvsweb is friendly to caches by indicating a suitable
                    423: # last-modified timestamp. Doing this uses slightly more
                    424: # CPU so you might want to disable it if you have a slow
                    425: # server
                    426: $use_moddate = 1;
                    427:
3.12      knu       428: # Allows downloading a tarball of the current directory if set.
                    429: # Bear in mind that this allows downloading a tarball of your entire
                    430: # repository, which can take a lot of time and disk space to create!
                    431: # If you enable this, you may need to make sure that cvsweb can write to
                    432: # CVSROOT/val-tags, due to a bug in cvs.
                    433: $allow_tar = '';
3.13    ! knu       434:
        !           435: # Options to pass to tar(1).
        !           436: @tar_options = ();
        !           437: # e.g. @tar_options = qw(--ignore-failed-read);
        !           438: #      GNU tar has some useful options against unexpected errors.
        !           439:
        !           440: # Options to pass to cvs(1).
        !           441: @cvs_options = qw(-l);
        !           442: # e.g. @cvs_options = qw(-R -l);
        !           443: #      -R (read only access mode) is implemented only in FreeBSD's and
        !           444: #      OpenBSD's cvs(1).
3.12      knu       445:
                    446: 1;
3.1       knu       447: #EOF

CVSweb