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