Handle hostnames with upper-case letters
[webmin.git] / pserver / cvsweb.conf
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. 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 $
9 #
10 ###
11
12 ##############
13 # CVS Root
14 ##############
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
19 # whitespaces.
20 # Note, that cvsweb.cgi currently needs to have physical access
21 # to the CVS repository so :pserver:someone@xyz.com:/data/cvsroot
22 # won't work!
23
24 # 'symbolic_name' 'path_to_the_actual_repository'
25 %CVSROOT = ( 'Root' => $config{'cvsroot'} );
26
27 # This tree is enabled by default when
28 # you enter the page
29 $cvstreedefault = 'Root';
30
31 ##############
32 # Defaults for UserSettings
33 ##############
34 %DEFAULTVALUE = (
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
41
42       "sortby" => "file",
43
44       # hideattic: Hide or show files in Attic
45       #   1      Hide files in Attic
46       #   0      Show files in Attic
47
48       "hideattic" => "1",
49
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.
54
55       "logsort" => "date",
56
57       # f:       Default diff format
58       #   h      Human readable
59       #   u      Unified diff
60       #   c      Context diff
61       #   s      Side by side
62       "f" => "h",         
63
64       # hidecvsroot: Don't show the CVSROOT directory
65       #   1      Hide CVSROOT directory
66       #   0      Show CVSROOT directory
67       "hidecvsroot" => "0",
68
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",
73 );
74
75 ##############
76 # some layout stuff
77 ##############
78
79 # color settings in the body-tag
80 $body_tag = '<body text="#000000" bgcolor="#ffffff">';
81
82 # Wanna have a logo on the page ?
83 #$logo = '<img src="/icons/apache_pb.gif">';
84
85 # The title of the Page on startup
86 $defaulttitle = "CVS Repository";
87
88 # The address is shown on the footer
89 $address = "<font size=-1>CVSweb by &lt;zeller\@think.de&gt;</font>";
90
91 # Default page background color for the diffs
92 # and annotations
93 $backcolor = "#eeeeee";
94
95 # color of navigation Header for
96 # diffs and annotations
97 $navigationHeaderColor = '#9999ee';
98
99 open(HEADER, $config{'view_header'});
100 while(<HEADER>) {
101         $long_intro .= $_;
102         }
103 close(HEADER);
104
105 $short_instruction = <<EOT;
106 <p>
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. 
109 </p>
110 EOT
111
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
121 %ICONS  = (
122            back => [ ("[BACK]", "/images/left.gif", 20,   22) ],
123            dir  => [ ("[DIR]",  "/images/dir.gif",  20,   22) ],
124            file => [ ("[TXT]",  "/images/text.gif", 20,   22) ],
125            );
126
127 # the length to which the last logentry should
128 # be truncated when shown in the directory view
129 $shortLogLen = 80;
130
131 # Show author of last change
132 $show_author = 1;
133
134 ##############
135 # table view for directories
136 ##############
137
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
143 # large directory ..
144 $dirtable = 1;
145
146 # show different colors for even/odd rows
147 @tabcolors = ('#ccccee', '#ffffff');
148 $tablepadding = 2;
149
150 # Color of Header
151 $columnHeaderColorDefault = '#cccccc';
152 $columnHeaderColorSorted = '#88ff88';
153
154
155 # If you want to have colored borders 
156 # around each row, uncomment this
157 # $tableBorderColor = '#999999';
158
159 #
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
162 # CVSROOT.
163 #
164 @HideModules = ( 
165                  "CVSROOT",
166                 );
167
168 #
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\$");
175
176 #
177 # Use CVSROOT/CVSROOT/descriptions for describing the directories/modules
178 # See INSTALL section 8
179 #
180 $use_descriptions = 0;
181
182 ##############
183 # Human Readable Diff
184 ##############
185
186 # (c) 1998 H. Zeller <zeller@think.de>
187 #
188 # Generates two columns of color encoded
189 # diff; much like xdiff or emacs-ediff mode.
190 #
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>
195 #
196 # some parameters to screw:
197 ##
198
199 # make lines breakable so that the columns do not
200 # exceed the width of the browser
201 $hr_breakable = 1;
202
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)
207 $hr_funout = 0;
208
209 # ignore whitespaces for human readable diffs
210 # (indendation and stuff ..)
211 # ( '-w' option to diff)
212 $hr_ignwhite = 1;
213
214 # ignore diffs which are caused by
215 # keyword-substitution like $Id - Stuff
216 # ( '-kk' option to rcsdiff)
217 $hr_ignkeysubst = 1;
218
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";
228
229 # the width of the textinput of the
230 # request-diff-form
231 $inputTextSize = 12;
232
233 ##############
234 # Mime Types
235 ##############
236
237 # mapping to mimetypes to help
238 # cvsweb to guess the correct mime-type on
239 # checkout; you can use the mime.types from
240 # apache here:
241 $mime_types = '/usr/local/web/apache/conf/mime.types';
242
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
248 %MTYPES = (
249            "html"  => "text/html",
250            "shtml" => "text/html",
251            "gif"   => "image/gif",
252            "jpeg"  => "image/jpeg",
253            "jpg"   => "image/jpeg",   
254            "*"     => "text/plain",
255            );
256
257 ##############
258 # Misc
259 ##############
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
265 $allow_annotate = 1;
266
267 # allow pretty-printed version of files
268 $allow_markup = 1;
269
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]
274 $allow_compress = 1;
275
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;
281
282 # open Download-Links in another window
283 $open_extern_window = 1;
284
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
288 # size
289 #$extern_window_width = 600;
290 #$extern_window_height = 440;
291
292 # Edit Options
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);
297
298 # remember to set the path to your
299 # rcsutils: rlog, rcsdiff (gzip if you use compression)
300 #$ENV{'PATH'} = '/usr/local/bin';
301
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.
305 $checkout_magic = 1;
306
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;
316
317 # Background color of logentry in markup
318 $markupLogColor = "#ffffff";
319
320 # Show CVS log when viewing file contents
321 $show_log_in_markup = 1;
322
323 # Tabstop used to expand tabs in colored diffs. If undefined then
324 # tabs are always expanded to 8 spaces.
325 $tabstop = 8;
326
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");
332
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
336 # server
337 $use_moddate = 1;
338
339 #EOF