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