Annotation of cvsweb/cvsweb.conf, Revision 3.17
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.17 ! knu 10: # $Id: cvsweb.conf,v 3.16 2001/01/02 12:23:20 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.17 ! knu 26: # 'symbolic_name' => ['name_to_display', 'path_to_the_actual_repository']
! 27: # Listed in the order specified:
! 28: @CVSrepositories = (
! 29: 'local' => ['Local Repository', '/home/cvs'],
! 30: # 'freebsd' => ['FreeBSD', '/home/ncvs'],
! 31: # 'openbsd' => ['OpenBSD', '/home/ncvs'],
! 32: # 'netbsd' => ['NetBSD', '/home/ncvs'],
! 33: # 'ruby' => ['Ruby', '/var/anoncvs/ruby'],
! 34: );
3.1 knu 35:
36: # This tree is enabled by default when
37: # you enter the page
3.17 ! knu 38: $cvstreedefault = $CVSrepositories[2 * 0]; # The first one
3.1 knu 39:
40: ##############
3.15 knu 41: # Bug tracking system options
42: # ("PR" means Problem Report, as in GNATS)
3.1 knu 43: ##############
3.15 knu 44: #@prcategories = qw(
45: # advocacy
46: # alpha
47: # bin
48: # conf
49: # docs
50: # gnu
51: # i386
52: # kern
53: # misc
54: # pending
55: # ports
56: # sparc
57: # );
58: #
59: #$prcgi = "http://www.FreeBSD.org/cgi/query-pr.cgi?pr=%s";
60: #
61: #$prkeyword = "PR";
3.1 knu 62:
63: ##############
3.15 knu 64: # Manual gateway
3.8 knu 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 <knu\@FreeBSD.org></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: <<a href="mailto:fenner\@FreeBSD.org">fenner\@FreeBSD.org</a>>
3.1 knu 151: and improved by Henner Zeller
152: <<a href="mailto:zeller\@think.de">zeller\@think.de</a>>,
153: Henrik Nordström
154: <<a href="mailto:hno\@hem.passagen.se">hno\@hem.passagen.se</a>>, and
155: Ken Coar
156: <<a href="mailto:Ken.Coar\@Golux.Com">Ken.Coar\@Golux.Com</a>>, then
157: Akinori MUSHA <<a href="mailto:knu\@FreeBSD.org">knu\@FreeBSD.org</a>>
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ö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
3.15 knu 195: my $iconsdir = "/icons";
196: # format: TEXT ICON-URL width height
3.1 knu 197: %ICONS = (
3.15 knu 198: back => [ ("[BACK]", "$iconsdir/back.gif", 20, 22) ],
199: dir => [ ("[DIR]", "$iconsdir/dir.gif", 20, 22) ],
200: file => [ ("[TXT]", "$iconsdir/text.gif", 20, 22) ],
201: );
202: undef $iconsdir;
3.1 knu 203:
204: # the length to which the last logentry should
205: # be truncated when shown in the directory view
206: $shortLogLen = 80;
207:
208: # Show author of last change
209: $show_author = 1;
210:
211: ##############
212: # table view for directories
213: ##############
214:
215: # Show directory as table
216: # this is much more readable but has one
217: # drawback: the whole table has to be loaded
218: # before common browsers display it which may
219: # be annoying if you have a slow link - and a
220: # large directory ..
221: $dirtable = 1;
222:
223: # show different colors for even/odd rows
224: @tabcolors = ('#ffffff', '#ffffff');
225: $tablepadding = 2;
226:
227: # Color of Header
228: $columnHeaderColorDefault = '#ffffcc';
229: $columnHeaderColorSorted = '#ffcc66';
230:
231: #
232: # If you want to have colored borders
233: # around each row, uncomment this
234: $tableBorderColor = '#cccccc';
235:
236: #
237: # Modules in the repository that should not be displayed, either by default
238: # nor by explicit path specification.
239: #
240: @HideModules = (
241: );
242:
243: #
244: # Use CVSROOT/CVSROOT/descriptions for describing the directories/modules
245: # See INSTALL section 8
246: #
247: $use_descriptions = 0;
248:
249: ##############
250: # Human Readable Diff
251: ##############
252:
253: # (c) 1998 H. Zeller <zeller@think.de>
254: #
255: # Generates two columns of color encoded
256: # diff; much like xdiff or emacs-ediff mode.
257: #
258: # The diff-stuff is a piece of code I once made for
259: # cvs2html which is under GPL,
260: # see http://www.sslug.dk/cvs2html
261: # (c) 1997/98 Peter Toft <pto@sslug.imm.dtu.dk>
262: #
263: # some parameters to screw:
264: ##
265:
266: # make lines breakable so that the columns do not
267: # exceed the width of the browser
268: $hr_breakable = 1;
269:
3.4 knu 270: # give out function names in diffs
3.1 knu 271: # this just makes sense if we have C-files, otherwise
272: # diff's heuristic doesn't work well ..
273: # ( '-p' option to diff)
3.4 knu 274: $showfunc = 1;
3.1 knu 275:
276: # For each pair of regexps, files that match the first regexp will be diff'ed
277: # with an '-F' option with the second regexp.
3.4 knu 278: %funcline_regexp = (
3.15 knu 279: "\\.(4th|fr)\$" => "\\(^\\|[ \t]\\): ",
280: "\\.rb\$" => "^[\t ]*\\(class\\|module\\|def\\) ",
3.4 knu 281: );
3.1 knu 282:
283: # ignore whitespaces for human readable diffs
284: # (indendation and stuff ..)
285: # ( '-w' option to diff)
3.7 knu 286: $hr_ignwhite = 0;
3.1 knu 287:
288: # ignore diffs which are caused by
289: # keyword-substitution like $Id - Stuff
290: # ( '-kk' option to rcsdiff)
291: $hr_ignkeysubst = 1;
292:
293: # Colors and font to show the diff type of code changes
294: $diffcolorHeading = '#99cccc'; # color of 'Line'-head of each diffed file
295: $diffcolorEmpty = '#cccccc'; # color of 'empty' lines
296: $diffcolorRemove = '#ff9999'; # Removed line(s) (left) ( - )
297: $diffcolorChange = '#99ff99'; # Changed line(s) ( both )
298: $diffcolorAdd = '#ccccff'; # Added line(s) ( - ) (right)
299: $diffcolorDarkChange = '#99cc99'; # lines, which are empty in change
300: $difffontface = "Helvetica,Arial";
301: $difffontsize = "-1";
302:
303: # the width of the textinput of the
304: # request-diff-form
305: $inputTextSize = 12;
306:
307: ##############
308: # Mime Types
309: ##############
310:
311: # mapping to mimetypes to help
312: # cvsweb to guess the correct mime-type on
313: # checkout; you can use the mime.types from
314: # apache here:
315: $mime_types = '/usr/local/etc/apache/mime.types';
316:
317: # quick mime-type lookup; maps file-suffices to
318: # mime-types for displaying checkouts in the browser.
319: # Further MimeTypes will be found in the
320: # file $mime_types (apache style mime.types - file)
321: # - add common mappings here for faster lookup
322: %MTYPES = (
323: "html" => "text/html",
324: "shtml" => "text/html",
325: "gif" => "image/gif",
326: "jpeg" => "image/jpeg",
3.12 knu 327: "jpg" => "image/jpeg",
328: "png" => "image/png",
329: "xpm" => "image/xpm",
3.1 knu 330: "*" => "text/plain",
331: );
3.11 knu 332:
333: # Charset for HTML output
3.13 knu 334: $charset = '';
335: # e.g.
336: #$charset = $where =~ m,/ru[/_-], ? 'koi8-r'
337: # : $where =~ m,/zh[/_-], ? 'big5'
338: # : $where =~ m,/ja[/_-], ? 'x-euc-jp'
339: # : $where =~ m,/ko[/_-], ? 'x-euc-kr'
340: # : 'iso-8859-1';
3.1 knu 341:
342: ##############
343: # Misc
344: ##############
345: # allow annotation of files
346: # this requires rw-access to the
3.12 knu 347: # CVSROOT/history file (if you have one)
348: # and rw-access to the subdirectory to
349: # place the lock so you maybe don't want it
3.1 knu 350: $allow_annotate = 1;
351:
352: # allow pretty-printed version of files
353: $allow_markup = 1;
354:
355: # allow compression with gzip
356: # of output if the Browser accepts
357: # it (HTTP_ACCEPT_ENCODING=gzip)
358: # [make sure to have gzip in the path]
3.16 knu 359: $allow_compress = 0;
3.1 knu 360:
361: # Make use of javascript functions.
362: # This way you can select one of your CVSroot
363: # without pressing 'Go' (.. if you do have more
364: # than one CVSROOT defined)
365: $use_java_script = 1;
366:
367: # open Download-Links in another window
368: $open_extern_window = 1;
369:
370: # The size of this extern window; this size option
371: # needs use_java_script to be defined
372: # just comment them if you don't want to have a fixed
373: # size
374: #$extern_window_width = 600;
375: #$extern_window_height = 440;
376:
377: # Edit Options
378: # Enable form to edit your options (hideattic,sortbydate)
379: # this isn't necessary if you've $dirtable defined 'cause
380: # this allows editing of all your options more intuitive
381: $edit_option_form = (not $dirtable);
382:
3.16 knu 383: # Set the path for the following commands:
384: # cvs, rlog, rcsdiff
385: # gzip (if you enable $allow_compress)
386: # tar,rm (if you enable $allow_tar)
387: $ENV{'PATH'} = '/bin:/usr/bin:/usr/local/bin';
3.1 knu 388:
389: # If you have files which automatically refers to other files
390: # (such as HTML) then this allows you to browse the checked
391: # out files as if outside CVS.
392: $checkout_magic = 1;
393:
394: # Show last changelog message for sub directories
395: # The current implementation makes many assumptions and may show the
396: # incorrect file at some times. The main assumption is that the last
397: # modified file has the newest filedate. But some CVS operations
398: # touches the file without even when a new version is't checked in,
399: # and TAG based browsing essientially puts this out of order, unless
400: # the last checkin was on the same tag as you are viewing.
401: # Enable this if you like the feature, but don't rely on correct results.
402: $show_subdir_lastmod = 0;
403:
404: # Background color of logentry in markup
405: $markupLogColor = "#ffffff";
406:
407: # Show CVS log when viewing file contents
408: $show_log_in_markup = 1;
409:
3.13 knu 410: # Preformat when viewing file contents. This should be turned off
411: # when you have files in the repository that are in a multibyte
412: # encoding which uses HTML special characters ([<>&"]) as part of a
413: # multi-byte character. (such as iso-2022-jp, ShiftJIS, etc.)
414: # Otherwise those files will get screwed up in markup.
415: $preformat_in_markup = '';
416:
3.1 knu 417: # Tabstop used to expand tabs in colored diffs. If undefined then
418: # tabs are always expanded to 8 spaces.
419: $tabstop = 8;
420:
421: # if you wish to display absolute times in your local timezone,
422: # then define mytz and fill in the strings for your standard and
423: # daylight time. Note that you must also make sure the system
424: # timezone is correctly set.
425: # @mytz=("EST", "EDT");
426:
427: # cvsweb is friendly to caches by indicating a suitable
428: # last-modified timestamp. Doing this uses slightly more
429: # CPU so you might want to disable it if you have a slow
430: # server
431: $use_moddate = 1;
432:
3.12 knu 433: # Allows downloading a tarball of the current directory if set.
434: # Bear in mind that this allows downloading a tarball of your entire
435: # repository, which can take a lot of time and disk space to create!
436: # If you enable this, you may need to make sure that cvsweb can write to
437: # CVSROOT/val-tags, due to a bug in cvs.
438: $allow_tar = '';
3.13 knu 439:
440: # Options to pass to tar(1).
3.15 knu 441: @tar_options = qw();
3.13 knu 442: # e.g. @tar_options = qw(--ignore-failed-read);
443: # GNU tar has some useful options against unexpected errors.
444:
445: # Options to pass to cvs(1).
446: @cvs_options = qw(-l);
447: # e.g. @cvs_options = qw(-R -l);
448: # -R (read only access mode) is implemented only in FreeBSD's and
449: # OpenBSD's cvs(1).
3.12 knu 450:
451: 1;
3.1 knu 452: #EOF
CVSweb