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