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