2 # Configuration of cvsweb.cgi, the
3 # CGI interface to CVS Repositories.
5 # (c) 1998-1999 H. Zeller <zeller@think.de>
6 # 1999 H. Nordström <hno@hem.passagen.se>
7 # based on work by Bill Fenner <fenner@freebsd.org>
8 # $Id: cvsweb.conf,v 1.29 2001/07/23 09:14:52 hzeller Exp $
15 # CVSweb can handle several CVS-Repositories
16 # at once. Enter a short symbolic names and the
17 # full path of these repositories here.
18 # NOTE that the symbolic names may not contain
20 # Note, that cvsweb.cgi currently needs to have physical access
21 # to the CVS repository so :pserver:someone@xyz.com:/data/cvsroot
24 # 'symbolic_name' 'path_to_the_actual_repository'
25 %CVSROOT = ( 'Root' => $config{'cvsroot'} );
27 # This tree is enabled by default when
29 $cvstreedefault = 'Root';
32 # Defaults for UserSettings
35 # sortby: File sort order
36 # file Sort by filename
37 # rev Sort by revision number
38 # date Sort by commit date
39 # author Sort by author
40 # log Sort by log message
44 # hideattic: Hide or show files in Attic
45 # 1 Hide files in Attic
46 # 0 Show files in Attic
50 # logsort: Sort order for CVS logs
51 # date Sort revisions by date
52 # rev Sort revision by revision number
53 # cvs Don't sort them. Same order as CVS/RCS shows them.
57 # f: Default diff format
64 # hidecvsroot: Don't show the CVSROOT directory
65 # 1 Hide CVSROOT directory
66 # 0 Show CVSROOT directory
69 # hidenonreadable: Don't show entries which cannot be read
70 # 1 Hide non-readable entries
71 # 0 Show non-readable entries
72 "hidenonreadable" => "1",
79 # color settings in the body-tag
80 $body_tag = '<body text="#000000" bgcolor="#ffffff">';
82 # Wanna have a logo on the page ?
83 #$logo = '<img src="/icons/apache_pb.gif">';
85 # The title of the Page on startup
86 $defaulttitle = "CVS Repository";
88 # The address is shown on the footer
89 $address = "<font size=-1>CVSweb by <zeller\@think.de></font>";
91 # Default page background color for the diffs
93 $backcolor = "#eeeeee";
95 # color of navigation Header for
96 # diffs and annotations
97 $navigationHeaderColor = '#9999ee';
99 open(HEADER, $config{'view_header'});
105 $short_instruction = <<EOT;
107 Click on a directory to enter that directory. Click on a file to display
108 its revision history and to get a chance to display diffs between revisions.
112 # used icons; if icon-url is empty, the text representation is used; if
113 # you do not want to have an ugly tooltip for the icon, remove the
114 # text-representation.
115 # The width and height of the icon allow the browser to correcly display
116 # the table while still loading the icons.
117 # These default icons are coming with apache.
118 # If these icons are too large, check out the miniicons in the
119 # icons/ directory; they have a width/height of 16/16
120 # format: TEXT ICON-URL width height
122 back => [ ("[BACK]", "/images/left.gif", 20, 22) ],
123 dir => [ ("[DIR]", "/images/dir.gif", 20, 22) ],
124 file => [ ("[TXT]", "/images/text.gif", 20, 22) ],
127 # the length to which the last logentry should
128 # be truncated when shown in the directory view
131 # Show author of last change
135 # table view for directories
138 # Show directory as table
139 # this is much more readable but has one
140 # drawback: the whole table has to be loaded
141 # before common browsers display it which may
142 # be annoying if you have a slow link - and a
146 # show different colors for even/odd rows
147 @tabcolors = ('#ccccee', '#ffffff');
151 $columnHeaderColorDefault = '#cccccc';
152 $columnHeaderColorSorted = '#88ff88';
155 # If you want to have colored borders
156 # around each row, uncomment this
157 # $tableBorderColor = '#999999';
160 # Modules in the repository that should not be displayed, either by default
161 # nor by explicit path specification. Usually, you don't want to display
169 # Files matching this name shouldn't be checked out with cvsweb, since
170 # they may contain sensitive information. Simple file name based
171 # filter. Often, the CVSROOT/passwd is exposed and some people tend
172 # to check in their .cvspass, though this is a bad idea. These files shouldn't
173 # be readable by default. Thanks to Damian Gryski to point this out.
174 @DissallowRead = ( "\^.cvspass\$", "^passwd\$");
177 # Use CVSROOT/CVSROOT/descriptions for describing the directories/modules
178 # See INSTALL section 8
180 $use_descriptions = 0;
183 # Human Readable Diff
186 # (c) 1998 H. Zeller <zeller@think.de>
188 # Generates two columns of color encoded
189 # diff; much like xdiff or emacs-ediff mode.
191 # The diff-stuff is a piece of code I once made for
192 # cvs2html which is under GPL,
193 # see http://www.sslug.dk/cvs2html
194 # (c) 1997/98 Peter Toft <pto@sslug.imm.dtu.dk>
196 # some parameters to screw:
199 # make lines breakable so that the columns do not
200 # exceed the width of the browser
203 # give out function names in human readable diffs
204 # this just makes sense if we have C-files, otherwise
205 # diff's heuristic doesn't work well ..
206 # ( '-p' option to diff)
209 # ignore whitespaces for human readable diffs
210 # (indendation and stuff ..)
211 # ( '-w' option to diff)
214 # ignore diffs which are caused by
215 # keyword-substitution like $Id - Stuff
216 # ( '-kk' option to rcsdiff)
219 # Colors and font to show the diff type of code changes
220 $diffcolorHeading = '#99cccc'; # color of 'Line'-head of each diffed file
221 $diffcolorEmpty = '#cccccc'; # color of 'empty' lines
222 $diffcolorRemove = '#ff9999'; # Removed line(s) (left) ( - )
223 $diffcolorChange = '#99ff99'; # Changed line(s) ( both )
224 $diffcolorAdd = '#ccccff'; # Added line(s) ( - ) (right)
225 $diffcolorDarkChange = '#99cc99'; # lines, which are empty in change
226 $difffontface = "Helvetica,Arial";
227 $difffontsize = "-1";
229 # the width of the textinput of the
237 # mapping to mimetypes to help
238 # cvsweb to guess the correct mime-type on
239 # checkout; you can use the mime.types from
241 $mime_types = '/usr/local/web/apache/conf/mime.types';
243 # quick mime-type lookup; maps file-suffices to
244 # mime-types for displaying checkouts in the browser.
245 # Further MimeTypes will be found in the
246 # file $mime_types (apache style mime.types - file)
247 # - add common mappings here for faster lookup
249 "html" => "text/html",
250 "shtml" => "text/html",
251 "gif" => "image/gif",
252 "jpeg" => "image/jpeg",
253 "jpg" => "image/jpeg",
260 # allow annotation of files
261 # this requires rw-access to the
262 # CVSROOT/history - file and rw-access
263 # to the subdirectory to place the lock
264 # so you maybe don't want it
267 # allow pretty-printed version of files
270 # allow compression with gzip
271 # of output if the Browser accepts
272 # it (HTTP_ACCEPT_ENCODING=gzip)
273 # [make sure to have gzip in the path]
276 # Make use of javascript functions.
277 # This way you can select one of your CVSroot
278 # without pressing 'Go' (.. if you do have more
279 # than one CVSROOT defined)
280 $use_java_script = 1;
282 # open Download-Links in another window
283 $open_extern_window = 1;
285 # The size of this extern window; this size option
286 # needs use_java_script to be defined
287 # just comment them if you don't want to have a fixed
289 #$extern_window_width = 600;
290 #$extern_window_height = 440;
293 # Enable form to edit your options (hideattic,sortbydate)
294 # this isn't necessary if you've $dirtable defined 'cause
295 # this allows editing of all your options more intuitive
296 $edit_option_form = (not $dirtable);
298 # remember to set the path to your
299 # rcsutils: rlog, rcsdiff (gzip if you use compression)
300 #$ENV{'PATH'} = '/usr/local/bin';
302 # If you have files which automatically refers to other files
303 # (such as HTML) then this allows you to browse the checked
304 # out files as if outside CVS.
307 # Show last changelog message for sub directories
308 # The current implementation makes many assumptions and may show the
309 # incorrect file at some times. The main assumption is that the last
310 # modified file has the newest filedate. But some CVS operations
311 # touches the file without even when a new version is't checked in,
312 # and TAG based browsing essientially puts this out of order, unless
313 # the last checkin was on the same tag as you are viewing.
314 # Enable this if you like the feature, but don't rely on correct results.
315 $show_subdir_lastmod = 0;
317 # Background color of logentry in markup
318 $markupLogColor = "#ffffff";
320 # Show CVS log when viewing file contents
321 $show_log_in_markup = 1;
323 # Tabstop used to expand tabs in colored diffs. If undefined then
324 # tabs are always expanded to 8 spaces.
327 # if you wish to display absolute times in your local timezone,
328 # then define mytz and fill in the strings for your standard and
329 # daylight time. Note that you must also make sure the system
330 # timezone is correctly set.
331 # @mytz=("EST", "EDT");
333 # cvsweb is friendly to caches by indicating a suitable
334 # last-modified timestamp. Doing this uses slightly more
335 # CPU so you might want to disable it if you have a slow