/[config]/viewvc.conf

Contents of /viewvc.conf

Parent Directory Parent Directory | Revision Log Revision Log


Revision 52 - (show annotations) (download)
Wed Feb 17 09:58:56 2010 PST (6 months, 2 weeks ago) by hulet
File size: 35775 byte(s)
viewvc.conf
1 ##---------------------------------------------------------------------------
2 ##
3 ## Configuration file for ViewVC
4 ##
5 ## Information on ViewVC is located at the following web site:
6 ## http://viewvc.org/
7 ##
8 ##---------------------------------------------------------------------------
9
10 ## THE FORMAT OF THIS CONFIGURATION FILE
11 ##
12 ## This file is delineated by sections, specified in [brackets]. Within
13 ## each section, are a number of configuration settings. These settings
14 ## take the form of: name = value. Values may be continued on the
15 ## following line by indenting the continued line.
16 ##
17 ## WARNING: Indentation *always* means continuation. Name=value lines
18 ## should always start in column zero.
19 ##
20 ## Comments should always start in column zero, and are identified
21 ## with "#". By default each of the configuration items is
22 ## commented out, with the default value of the option shown.
23 ## You'll need to remove the '#' that precedes configuration
24 ## options whose values you wish to modify.
25 ##
26 ## Certain configuration settings may have multiple values. These should
27 ## be separated by a comma. The settings where this is allowed are noted
28 ## below. Any other setting that requires special syntax is noted at that
29 ## setting.
30 ##
31 ##
32 ## SOME TERMINOLOGY USED HEREIN
33 ##
34 ## "root" - This is a CVS or Subversion repository. For Subversion, the
35 ## meaning is pretty clear, as the virtual, versioned directory tree
36 ## stored inside a Subversion repository looks nothing like the actual
37 ## tree visible with shell utilities that holds the repository. For
38 ## CVS, this is more confusing, because CVS's repository layout mimics
39 ## (actually, defines) the layout of the stuff housed in the repository.
40 ## But a CVS repository can be identified by the presence of a CVSROOT
41 ## subdirectory in its root directory.
42 ##
43 ## "module" - A module is a top-level subdirectory of a root, usually
44 ## associated with the concept of a single "project" among many housed
45 ## within a single repository.
46 ##
47 ##
48 ## BASIC VIEWVC CONFIGURATION HINTS
49 ##
50 ## While ViewVC has quite a few configuration options, you generally
51 ## only need to change a small subset of them to get your ViewVC
52 ## installation working properly. Here are some options that we
53 ## recommend you pay attention to. Of course, don't try to change the
54 ## options here -- do so in the relevant section of the configuration
55 ## file below.
56 ##
57 ## For correct operation, you will probably need to change the following
58 ## configuration variables:
59 ##
60 ## cvs_roots (for CVS)
61 ## svn_roots (for Subversion)
62 ## root_parents (for CVS or Subversion)
63 ## default_root
64 ## root_as_url_component
65 ## rcs_dir
66 ## mime_types_files
67 ## the many options in the [utilities] section
68 ##
69 ## It is usually desirable to change the following variables:
70 ##
71 ## address
72 ## forbidden
73 ##
74 ## To optimize delivery of ViewVC static files:
75 ##
76 ## docroot
77 ##
78 ## To customize the display of ViewVC for your site:
79 ##
80 ## template_dir
81 ## the [templates] override section
82 ##
83
84 ##---------------------------------------------------------------------------
85 [general]
86
87 ## cvs_roots: Specifies each of the CVS roots on your system and
88 ## assigns names to them. Each root should be given by a "name: path"
89 ## value. Multiple roots should be separated by commas and can be
90 ## placed on separate lines.
91 ##
92 ## Example:
93 ## cvs_roots = cvsroot: /opt/cvs/repos1,
94 ## anotherroot: /usr/local/cvs/repos2
95 ##
96 #cvs_roots =
97
98 ## svn_roots: Specifies each of the Subversion roots (repositories) on
99 ## your system and assigns names to them. Each root should be given by
100 ## a "name: path" value. Multiple roots should be separated by commas
101 ## and can be placed on separate lines.
102 ##
103 ## Example:
104 ## svn_roots = svnrepos: /opt/svn/,
105 ## anotherrepos: /usr/local/svn/repos2
106 ##
107 #svn_roots =
108 svn_roots = config: /home/hulet/svn/config,
109 dlp: /home/hulet/svn/dlp,
110 greasemonkey: /home/hulet/svn/greasemonkey,
111
112 ## root_parents: Specifies a list of directories in which any number of
113 ## repositories may reside. Rather than force you to add a new entry
114 ## to 'cvs_roots' or 'svn_roots' each time you create a new repository,
115 ## ViewVC rewards you for organising all your repositories under a few
116 ## parent directories by allowing you to simply specifiy just those
117 ## parent directories. ViewVC will then notice each repository in that
118 ## directory as a new root whose name is the subdirectory of the parent
119 ## path in which that repository lives.
120 ##
121 ## You can specify multiple parent paths separated by commas or new lines.
122 ##
123 ## WARNING: these names can, of course, clash with names you have
124 ## defined in your cvs_roots or svn_roots configuration items. If this
125 ## occurs, you can either rename the offending repository on disk, or
126 ## grant new names to the clashing item in cvs_roots or svn_roots.
127 ## Each parent path is processed sequentially, so repositories under
128 ## later parent paths may override earlier ones.
129 ##
130 ## Example:
131 ## root_parents = /opt/svn : svn,
132 ## /opt/cvs : cvs
133 ##
134 #root_parents =
135 #root_parents = /home/hulet/svn : svn
136
137 ## default_root: This is the name of the default root. Valid names
138 ## include those explicitly listed in the cvs_roots and svn_roots
139 ## configuration options, as well as those implicitly indicated by
140 ## virtue of being the basenames of repositories found in the
141 ## root_parents option locations.
142 ##
143 ## Note: This setting is ignored when root_as_url_component is enabled.
144 ##
145 ## Example:
146 ## default_root = cvsroot
147 ##
148 #default_root =
149 default_root = svn
150
151 ## mime_types_files: This is a list of pathnames to a set of MIME type
152 ## mapping files to help ViewVC guess the correct MIME type of a
153 ## versioned file. The pathnames listed here are specified in order of
154 ## authoritativeness either as absolute paths or relative to this
155 ## configuration file.
156 ##
157 ## As a convenience, ViewVC provides a MIME type mapping file
158 ## (mimetypes.conf) which is, by default, the preferred provider of
159 ## MIME type mapping answers, but which is also empty. If you find
160 ## that ViewVC is unable to accurately guess MIME types based on the
161 ## extensions of some of your versioned files, you can add records of
162 ## your preferred mappings to the provided mimetypes.conf file (or to
163 ## your system's mapping files, if you wish).
164 ##
165 ## You might, for example, wish to have ViewVC also consult the mapping
166 ## files provided by your operating system and Apache.
167 ##
168 ## Example:
169 ## mime_types_files = mimetypes.conf,
170 ## /etc/mime.types,
171 ## /usr/local/apache2/conf/mime.types
172 ##
173 #mime_types_files = mimetypes.conf
174
175 ## address: The address of the local repository maintainer. (This
176 ## option is provided only as a convenience for ViewVC installations
177 ## which are using the default template set, where the value of this
178 ## option will be displayed in the footer of every ViewVC page.)
179 ##
180 ## Example:
181 ## address = admin@server.com
182 ##
183 #address =
184
185 ## kv_files: Provides a mechanism for custom key/value pairs to be
186 ## available to templates. These are stored in key/value (KV) files.
187 ##
188 ## The paths of the KV files are listed here, specified either as
189 ## absolute paths or relative to this configuration file. The files
190 ## use the same format as this configuration file, containing one or
191 ## more user-defined sections, and user-defined options in those
192 ## sections. ViewVC makes these options available to template authors
193 ## as:
194 ##
195 ## kv.SECTION.OPTION
196 ##
197 ## Note that an option name can be dotted. For example:
198 ##
199 ## [my_images]
200 ## logos.small = /images/small-logo.png
201 ## logos.big = /images/big-logo.png
202 ##
203 ## Templates can use these with a directive like: [kv.my_images.logos.small]
204 ##
205 ## Note that section names which are common to multiple KV files will
206 ## be merged. If two files have a [my_images] section, then the
207 ## options in those two like-named sections will be merged together.
208 ## If two files have the same option name in a section, then one will
209 ## overwrite the other (and which one "wins" is unspecified).
210 ##
211 ## To further categorize the KV files, and how the values are provided to
212 ## the templates, a KV file name may be annotated with an additional level
213 ## of dotted naming. For example:
214 ##
215 ## kv_files = [asf]kv/images.conf
216 ##
217 ## Assuming the same section as above, the template would refer to an image
218 ## using [kv.asf.my_images.logos.small]
219 ##
220 ## Lastly, it is possible to use %lang% in the filenames to specify a
221 ## substitution of the selected language-tag.
222 ##
223 ## Example:
224 ## kv_files = kv/file1.conf, kv/file2.conf, [i18n]kv/%lang%_data.conf
225 ##
226 #kv_files =
227
228 ## This option is a comma-separated list of language-tag values
229 ## available to ViewVC. The first language-tag listed is the default
230 ## language, and will be used if an Accept-Language header is not
231 ## present in the request, or none of the user's requested languages
232 ## are available. If there are ties on the selection of a language,
233 ## then the first to appear in the list is chosen.
234 ##
235 ## Example:
236 ## languages = en-us, en-gb, de
237 ##
238 #languages = en-us
239
240
241 ##---------------------------------------------------------------------------
242 [utilities]
243
244 ## ViewVC uses (sometimes optionally) various third-party programs to do some
245 ## of the heavy lifting. Generally, it will attempt to execute those utility
246 ## programs in such a way that if they are found in ViewVC's executable
247 ## search path ($PATH, %PATH%, etc.) all is well. But sometimes these tools
248 ## aren't installed in the executable search path, so here's where you can
249 ## tell ViewVC where to find them.
250 ##
251 ## NOTE: Options with a "_dir" suffix are for configuring the directories
252 ## in which certain programs live; otherwise, the option value should
253 ## point to the actual program.
254
255
256 ## rcs_dir: Directory in which the RCS utilities are installed, used
257 ## for viewing CVS repositories.
258 ##
259 ## Example:
260 ## rcs_dir = /usr/bin/
261 ##
262 #rcs_dir =
263
264 ## cvsnt: Location of cvsnt program. ViewVC can use CVSNT (www.cvsnt.org)
265 ## instead of the RCS utilities to retrieve information from CVS
266 ## repositories. To enable use of CVSNT, set the "cvsnt" value to the
267 ## path of the CVSNT executable. (If CVSNT is on the standard path, you
268 ## can also set it to the name of the CVSNT executable). By default
269 ## "cvsnt" is set to "cvs" on Windows and is not set on other platforms.
270 ##
271 ## Examples:
272 ## cvsnt = K:\Program Files\cvsnt\cvs.exe
273 ## cvsnt = /usr/bin/cvs
274 ## cvsnt = cvs
275 ##
276 #cvsnt =
277
278 ## svn: Location of the Subversion command-line client, used for
279 ## viewing Subversion repositories.
280 ##
281 ## Example:
282 ## svn = /usr/bin/svn
283 ##
284 #svn =
285
286 ## diff: Location of the GNU diff program, used for showing file
287 ## version differences.
288 ##
289 ## Example:
290 ## diff = /usr/bin/diff
291 ##
292 #diff =
293
294 ## cvsgraph: Location of the CvsGraph program, a graphical CVS version
295 ## graph generator (see options.use_cvsgraph).
296 ##
297 ## Example:
298 ## cvsgraph = /usr/local/bin/cvsgraph
299 ##
300 #cvsgraph =
301
302
303 ##---------------------------------------------------------------------------
304 [options]
305
306 ## root_as_url_component: Interpret the first path component in the URL
307 ## after the script location as the root to use. This is an
308 ## alternative to using the "root=" query key. If ViewVC is configured
309 ## with multiple repositories, this results in more natural looking
310 ## ViewVC URLs.
311 ## Note: Enabling this option will break backwards compatibility with
312 ## any old ViewCVS URL which doesn't have an explicit "root" parameter.
313 ##
314 #root_as_url_component = 1
315 root_as_url_component = 1
316
317 ## checkout_magic: Use checkout links with magic /*checkout*/ prefixes so
318 ## checked out HTML pages can have working links to other repository files
319 ## Note: This option is DEPRECATED and should not be used in new ViewVC
320 ## installations. Setting "default_file_view = co" achieves the same effect
321 ##
322 #checkout_magic = 0
323
324 ## allowed_views: List the ViewVC views which are enabled. Views not
325 ## in this comma-delited list will not be served (or, will return an
326 ## error on attempted access).
327 ## Possible values: "annotate", "co", "diff", "markup", "roots", "tar"
328 ##
329 allowed_views = annotate, co, diff, markup, roots, tar
330
331 ## authorizer: The name of the ViewVC authorizer plugin to use when
332 ## authorizing access to repository contents. This value must be the
333 ## name of a Python module addressable as vcauth.MODULENAME (most
334 ## easily accomplished by placing it in ViewVC's lib/vcauth/ directory)
335 ## and which implements a ViewVCAuthorizer class (as a subclass of
336 ## vcauth.GenericViewVCAuthorizer). You can provide custom parameters
337 ## to the authorizer module by defining configuration sections named
338 ## authz-MODULENAME and adding the parameter keys and values there.
339 ##
340 ## ViewVC provides the following modules:
341 ## svnauthz - based on Subversion authz files
342 ## forbidden - simple path glob matches against top-level root directories
343 ## forbiddenre - root and path matches against regular expressions
344 ##
345 ## NOTE: Only one authorizer may be in use for a given ViewVC request.
346 ## It doesn't matter if you configure the parameters of multiple
347 ## authorizer plugins -- only the authorizer whose name is configured
348 ## here (or effectively configured here via per-vhost or per-root
349 ## configuration) will be activated.
350 ##
351 #authorizer =
352 #authorizer = svnauthz
353
354 ## hide_cvsroot: Don't show the CVSROOT directory
355 ## 1 Hide CVSROOT directory
356 ## 0 Show CVSROOT directory
357 ## NOTE: Someday this option may be removed in favor of letting
358 ## individual authorizer plugin hide the CVSROOT.
359 ##
360 #hide_cvsroot = 1
361
362 ## mangle_email_addresses: Mangle email addresses in marked-up output.
363 ## There are various levels of mangling available:
364 ## 0 - No mangling; markup un-mangled email addresses as hyperlinks
365 ## 1 - Obfuscation (using entity encoding); no hyperlinking
366 ## 2 - Data-dropping address truncation; no hyperlinking
367 ## Note: this will not effect the display of versioned file contents, only
368 ## addresses that appear in version control metadata (e.g. log messages).
369 ##
370 #mangle_email_addresses = 0
371
372 ## default_file_view: "log", "co", or "markup"
373 ## Controls whether the default view for file URLs is a checkout view or
374 ## a log view. "log" is the default for backwards compatibility with old
375 ## ViewCVS URLs, but "co" has the advantage that it allows ViewVC to serve
376 ## static HTML pages directly from a repository with working links
377 ## to other repository files
378 ## Note: Changing this option may break compatibility with existing
379 ## bookmarked URLs.
380 ## Also note: If you choose one of the "co" or "markup" views, be sure
381 ## to enable it (via the allowed_views option)
382 ##
383 #default_file_view = log
384
385 ## http_expiration_time: Expiration time (in seconds) for cacheable
386 ## pages served by ViewVC. Note that in most cases, a cache aware
387 ## client will only revalidate the page after it expires (using the
388 ## If-Modified-Since and/or If-None-Match headers) and that browsers
389 ## will also revalidate the page when the reload button is pressed.
390 ## Set to 0 to disable the transmission of these caching headers.
391 ##
392 #http_expiration_time = 600
393
394 ## generate_etags: Generate Etag headers for relevant pages to assist
395 ## in browser caching.
396 ## 1 Generate Etags
397 ## 0 Don't generate Etags
398 ##
399 #generate_etags = 1
400
401 ## svn_ignore_mimetype: Don't consult the svn:mime-type property to
402 ## determine how to display a file in the markup view. This is
403 ## especially helpful when versioned images carry the default
404 ## Subversion-calculated MIME type of "application/octet-stream" (which
405 ## isn't recognized as viewable type by browsers).
406 ##
407 #svn_ignore_mimetype = 0
408
409 ## svn_config_dir: Path of the Subversion runtime configuration
410 ## directory ViewVC should consult for various things, including cached
411 ## remote authentication credentials. If unset, Subversion will use
412 ## the default location(s) ($HOME/.subversion, etc.)
413 ##
414 #svn_config_dir =
415
416 ## use_rcsparse: Use the rcsparse Python module to retrieve CVS
417 ## repository information instead of invoking rcs utilities [EXPERIMENTAL]
418 ##
419 #use_rcsparse = 0
420
421 ## sort_by: File sort order
422 ## file Sort by filename
423 ## rev Sort by revision number
424 ## date Sort by commit date
425 ## author Sort by author
426 ## log Sort by log message
427 ##
428 #sort_by = file
429
430 ## sort_group_dirs: Group directories when sorting
431 ## 1 Group directories together
432 ## 0 No grouping -- sort directories as any other item would be sorted
433 ##
434 #sort_group_dirs = 1
435
436 ## hide_attic: Hide or show the contents of the Attic subdirectory
437 ## 1 Hide dead files inside Attic subdir
438 ## 0 Show the files which are inside the Attic subdir
439 ##
440 #hide_attic = 1
441
442 ## hide_errorful_entries: Hide or show errorful directory entries
443 ## (perhaps due to not being readable, or some other rlog parsing
444 ## error, etc.)
445 ## 1 Hide errorful entries from the directory display
446 ## 0 Show errorful entries (with their errors) in the directory display
447 ##
448 #hide_errorful_entries = 0
449
450 ## log_sort: Sort order for log messages
451 ## date Sort revisions by date
452 ## rev Sort revision by revision number
453 ## none Use the version control system's ordering
454 ##
455 #log_sort = date
456
457 ## diff_format: Default diff format
458 ## h Human readable
459 ## u Unified diff
460 ## c Context diff
461 ## s Side by side
462 ## l Long human readable (more context)
463 ## f Full human readable (entire file)
464 ##
465 #diff_format = h
466 diff_format = u
467
468 ## hr_breakable: Diff view line breaks
469 ## 1 lines break at spaces
470 ## 0 no line breaking
471 ## Or, use a positive integer > 1 to cut lines after that many characters
472 ##
473 #hr_breakable = 1
474
475 ## hr_funout: Give out function names in human readable diffs.
476 ## (Only works well for C source files, otherwise diff's heuristic falls short.)
477 ## ('-p' option to diff)
478 ##
479 #hr_funout = 0
480
481 ## hr_ignore_white: Ignore whitespace (indendation and stuff) for human
482 ## readable diffs.
483 ## ('-w' option to diff)
484 ##
485 #hr_ignore_white = 0
486
487 ## hr_ignore_keyword_subst: Ignore diffs which are caused by keyword
488 ## substitution (such as "$Id - Stuff").
489 ## ('-kk' option to rcsdiff)
490 ##
491 #hr_ignore_keyword_subst = 1
492
493 ## hr_intraline: Enable highlighting of intraline changes in human
494 ## readable diffs. [Requires Python 2.4]
495 ##
496 #hr_intraline = 0
497 hr_intraline = 1
498
499 ## allow_compress: Allow compression via gzip of output if the Browser
500 ## accepts it (HTTP_ACCEPT_ENCODING contains "gzip").
501 ##
502 ## Note: this relies on Python's gzip module, which has proven to be
503 ## not-so-performant. Enabling this feature should reduce the overall
504 ## transfer size of ViewVC's responses to the client's request, but
505 ## will do so with a speed penalty.
506 ##
507 #allow_compress = 0
508
509 ## template_dir: The directory which contains the EZT templates used by
510 ## ViewVC to customize the display of the various output views. ViewVC
511 ## looks in this directory for files with names that match the name of
512 ## the view ("log", "directory", etc.) plus the ".ezt" extension. If
513 ## specified as a relative path, it is relative to the directory where
514 ## this config file resides; absolute paths may be used as well. If
515 ## %lang% occurs in the pathname, then the selected language will be
516 ## substituted.
517 ## See Also: the [templates] configuration section, where you can
518 ## override templates on a per-view basis.
519 ##
520 #template_dir = templates-contrib/newvc/templates
521
522 ## docroot: Web path to a directory that contains ViewVC static files
523 ## (stylesheets, images, etc.) If set, static files will get
524 ## downloaded directory from this location. If unset, static files
525 ## will be served by the ViewVC script (at a likely performance
526 ## penalty, and from the "docroot" subdirectory of the directory
527 ## specified by the "template_dir" option).
528 ##
529 #docroot =
530
531 ## show_subdir_lastmod: Show last changelog message for CVS subdirectories
532 ## NOTE: The current implementation makes many assumptions and may show
533 ## the incorrect file at some times. The main assumption is that the
534 ## last modified file has the newest filedate. But some CVS operations
535 ## touches the file without even when a new version is not checked in,
536 ## and TAG based browsing essentially puts this out of order, unless
537 ## the last checkin was on the same tag as you are viewing. Enable
538 ## this if you like the feature, but don't rely on correct results.
539 ##
540 ## ** WARNING: Enabling this will currently leak unauthorized path names **
541 ##
542 #show_subdir_lastmod = 0
543
544 ## show_logs: Show the most recent log entry in directory listings.
545 ##
546 #show_logs = 1
547
548 ## show_log_in_markup: Show log when viewing file contents.
549 ##
550 #show_log_in_markup = 1
551
552 ## cross_copies: Cross filesystem copies when traversing Subversion
553 ## file revision histories.
554 ##
555 #cross_copies = 1
556
557 ## use_localtime: Display dates as UTC or in local time zone.
558 ##
559 #use_localtime = 0
560 use_localtime = 1
561
562 ## short_log_len: The length (in characters) to which the most recent
563 ## log entry should be truncated when shown in the directory view.
564 ##
565 #short_log_len = 80
566
567 ## enable_syntax_coloration: Should we colorize known file content
568 ## syntaxes? [Requires Pygments Python module]
569 ##
570 enable_syntax_coloration = 1
571
572 ## detect_encoding: Should we attempt to detect versioned file
573 ## character encodings? [Requires 'chardet' module, and is currently
574 ## used only by the syntax coloration logic -- if enabled -- for the
575 ## 'markup' and 'annotate' views; see 'enable_syntax_coloration'.]
576 ##
577 #detect_encoding = 0
578
579 ## use_cvsgraph: Use CvsGraph to offer visual graphs of CVS revision history.
580 ##
581 #use_cvsgraph = 0
582
583 ## cvsgraph_conf: Location of the customized cvsgraph configuration file.
584 ## May be specified as an absolute path or as a path relative to this
585 ## configuration file.
586 ##
587 #cvsgraph_conf = cvsgraph.conf
588
589 ## use_re_search: Enable regular expression search of files in a directory.
590 ##
591 ## WARNING: Enabling this option can consume HUGE amounts of server
592 ## time. A "checkout" must be performed on *each* file in a directory,
593 ## and the result needs to be searched for a match against the regular
594 ## expression.
595 ##
596 ## SECURITY WARNING: Since a user can enter the regular expression, it
597 ## is possible for them to enter an expression with many alternatives
598 ## and a lot of backtracking. Executing that search over thousands of
599 ## lines over dozens of files can easily tie up a server for a long
600 ## period of time. This option should only be used on sites with
601 ## trusted users. It is highly inadvisable to use this on a public site.
602 ##
603 #use_re_search = 0
604
605 ## dir_pagesize: Maximum number of directory entries on a given page.
606 ## This allows ViewVC to present discrete pages to the users instead of
607 ## the entire directory. Set to 0 to disable pagination.
608 ##
609 #dir_pagesize = 0
610
611 ## log_pagesize: Maximum number of revision log entries on a given page.
612 ## This allows ViewVC to present discrete pages to the users instead of
613 ## the entire revision log. Set to 0 to disable pagination.
614 ##
615 #log_pagesize = 0
616 log_pagesize = 100
617
618 ## limit_changes: Maximum number of changed paths shown per commit in
619 ## the Subversion revision view and in query results. This is not a
620 ## hard limit (the UI provides options to show all changed paths), but
621 ## it prevents ViewVC from generating enormous and hard to read pages
622 ## by default when they happen to contain import or merge commits
623 ## affecting hundreds or thousands of files. Set to 0 to disable the
624 ## limit.
625 ##
626 #limit_changes = 100
627
628 ##---------------------------------------------------------------------------
629 [templates]
630
631 ## You can override the templates used by various ViewVC views in this
632 ## section. By default, ViewVC will look for templates in the
633 ## directory specified by the "template_dir" configuration option (see
634 ## the documentation for that option for details). But if you want to
635 ## use a different template for a particular view, simply uncomment the
636 ## appropriate option below and specify the currect location of the EZT
637 ## template file you wish to use for that view.
638 ##
639 ## Templates are specified relative to the configured template
640 ## directory (see the "template_dir" option), but absolute paths may
641 ## also be used as well.
642 ##
643 ## If %lang% occurs in the pathname, then the selected language will be
644 ## substituted.
645 ##
646 ## Note: the selected language is defined by the "languages" item in the
647 ## [general] section, and based on the request's Accept-Language
648 ## header.
649 ##
650
651 ## diff: Template used for the file differences view.
652 ##
653 #diff =
654
655 ## directory: Template used for the directory listing view.
656 ##
657 #directory =
658
659 ## error: Template used for the ViewVC error display view.
660 ##
661 #error =
662
663 ## file: Template used for the file contents/annotation view.
664 ##
665 #file =
666
667 ## graph: Template used for the revision graph view.
668 ##
669 #graph =
670
671 ## log: Template used for the revision log view.
672 ##
673 #log =
674
675 ## query: Template used for the non-integrated query interface.
676 ##
677 #query =
678
679 ## query_form: Template used for the query form view.
680 ##
681 #query_form =
682
683 ## query_results: Template used for the query results view.
684 ##
685 #query_results =
686
687 ## revision: Template used for the revision/changeset view.
688 ##
689 #revision =
690
691 ## roots: Template used for the root listing view.
692 ##
693 #roots =
694
695 ##---------------------------------------------------------------------------
696 [cvsdb]
697
698 ## enabled: Enable database integration feature.
699 ##
700 #enabled = 0
701
702 ## host: Database hostname. Leave unset to use a local Unix socket
703 ## connection.
704 ##
705 #host =
706
707 ## post: Database listening port.
708 ##
709 #port = 3306
710
711 ## database_name: ViewVC database name.
712 ##database_name = ViewVC
713
714 ## user: Username of user with read/write privileges to the database
715 ## specified by the 'database_name' configuration option.
716 ##
717 #user =
718
719 ## passwd: Password of user with read/write privileges to the database
720 ## specified by the 'database_name' configuration option.
721 ##
722 #passwd =
723
724 ## readonly_user: Username of user with read privileges to the database
725 ## specified by the 'database_name' configuration option.
726 ##
727 #readonly_user =
728
729 ## readonly_passwd: Password of user with read privileges to the database
730 ## specified by the 'database_name' configuration option.
731 ##
732 #readonly_passwd =
733
734 ## row_limit: Maximum number of rows returned by a given normal query
735 ## to the database.
736 ##
737 #row_limit = 1000
738
739 ## rss_row_limit: Maximum number of rows returned by a given query to
740 ## the database made as part of an RSS feed request. (Keeping in mind
741 ## that RSS readers tend to poll regularly for new data, you might want
742 ## to keep this set to a conservative number.)
743 ##
744 #rss_row_limit = 100
745
746 ## check_database_for_root: Check if the repository is found in the
747 ## database before showing the query link and RSS feeds.
748 ##
749 ## WARNING: Enabling this check adds the cost of a database connection
750 ## and query to most ViewVC requests. If all your roots are represented
751 ## in the commits database, or if you don't care about the creation of
752 ## RSS and query links that might lead ultimately to error pages for
753 ## certain of your roots, or if you simply don't want to add this extra
754 ## cost to your ViewVC requests, leave this disabled.
755 ##
756 #check_database_for_root = 0
757
758 ##---------------------------------------------------------------------------
759 [vhosts]
760
761 ## Virtual hosts are individual logical servers accessible via
762 ## different hostnames, but which are all really the same physical
763 ## computer. For example, you might have your web server configured to
764 ## accept incoming traffic for both http://www.yourdomain.com/ and
765 ## http://viewvc.yourdomain.com/. Users pointing their web browsers at
766 ## each of those two URLs might see entirely different content via one
767 ## URL versus the other, but all that content actually lives on the
768 ## same computer, is served up via the same web server, and so
769 ## on. It just *looks* like its coming from multiple servers.
770 ##
771 ## ViewVC allows you to customize its configuration options for
772 ## individual virtual hosts. You might, for example, wish to expose
773 ## all of your Subversion repositories at http://svn.yourdomain.com/viewvc/
774 ## and all your CVS ones at http://cvs.yourdomain.com/viewvc/, with no
775 ## cross-exposure. Using ViewVC's virtual host (vhost) configuration
776 ## support, you can do this. Simply create two vhost configurations
777 ## (one for each of your hostnames), then configure the cvs_roots
778 ## option only for the vhost associated with cvs.yourdomain.com, and
779 ## configure the svn_roots option only for the vhost associated with
780 ## svn.yourdomain.com.
781 ##
782 ## This section is a freeform configuration section, where you create
783 ## both the option names and their values. The names of the options
784 ## are then treated as canonical names of virtual hosts, and their
785 ## values are defined to be comma-delimited lists of hostname globs
786 ## against which incoming ViewVC requests will be matched to figure out
787 ## which vhost they apply to.
788 ##
789 ## After you've named and defined your vhosts, you may then create new
790 ## configuration sections whose names are of the form
791 ## vhost-VHOSTNAME/CONFIGSECTION. VHOSTNAME here is the canonical name
792 ## of one of the virtual hosts you defined under the [vhosts] section.
793 ## Inside those configuration sections, you override the standard
794 ## ViewVC options typically found in the base configuration section
795 ## named CONFIGSECTION ("general", "option", etc.)
796 ##
797 ## Here is an example:
798 ##
799 ## [vhosts]
800 ## libs = libs.yourdomain.*, *.yourlibs.*
801 ## gui = guiproject.yourdomain.*
802 ##
803 ## [vhost-libs/general]
804 ## cvs_roots =
805 ## svn_roots = svnroot: /var/svn/libs-repos
806 ## default_root = svnroot
807 ##
808 ## [vhost-libs/options]
809 ## show_logs = 1
810 ##
811 ## [vhost-gui/general]
812 ## cvs_roots = cvsroot: /var/cvs/guiproject
813 ## svn_roots =
814 ## default_root = cvsroot
815 ##
816
817 viewvc2 = viewvc2.*
818 tmt = tmt.viewvc.*, tmt.code.*
819 web2review = web2review.viewvc.*, w2r.code.*
820 aiaonline = aia.viewvc.*, aia.code.*
821 handyman = handyman.code.*
822
823 aquire = aquire.code.*
824 fresh_website = fresh_website.code.*
825
826 [vhost-viewvc2/general]
827 svn_roots =
828 root_parents = /home/hulet/svn : svn
829
830 [vhost-tmt/general]
831 svn_roots = tmt: http://svn.t-mobiletowers.com/tmt/
832
833 [vhost-web2review/general]
834 svn_roots = web2review_website: /home/hulet/svn/web2review_website
835
836 [vhost-aiaonline/general]
837 svn_roots = aiaonline: /home/hulet/svn/aiaonline
838
839 [vhost-aquire/general]
840 svn_roots = aquire: /home/hulet/svn/aquire
841
842 [vhost-fresh_website/general]
843 svn_roots = fresh_website: /home/hulet/svn/fresh_website
844
845 [vhost-handyman/general]
846 svn_roots = handyman: http://svn.assembla.com/svn/Handyman/
847
848
849 ##---------------------------------------------------------------------------
850 ## ViewVC recognizes per-root configuration overrides, too. To
851 ## override the value of a configuration parameter only for a single
852 ## root, create a configuration section whose names is of the form
853 ## root-ROOTNAME/CONFIGSECTION. ROOTNAME here is the name of the root
854 ## as defined explicitly in cvs_roots or svn_roots or implicitly as the
855 ## basename of a root path in root_parents. Options found in this new
856 ## configuration section override for this one root the corresponding
857 ## options found in the base configuration section CONFIGSECTION
858 ## ("options", "authz-*", etc.)
859 ##
860 ## Here is an example showing how to enable Subversion authz-based
861 ## authorization for only the single root named "svnroot":
862 ##
863 ## [root-svnroot/options]
864 ## authorizer = svnauthz
865 ##
866 ## [root-svnroot/authz-svnauthz]
867 ## authzfile = /path/to/authzfile
868 ##
869
870 ##---------------------------------------------------------------------------
871 [authz-forbidden]
872
873 ## The "forbidden" authorizer forbids access to repository modules,
874 ## defined to be top-level subdirectories in a repository. You can use
875 ## a simple list of modules, or something more complex:
876 ##
877 ## *) The "!" can be used before a module to explicitly state that it
878 ## is NOT forbidden. Whenever this form is seen, then all modules will
879 ## be forbidden unless one of the "!" modules match.
880 ##
881 ## *) Shell-style "glob" expressions may be used. "*" will match any
882 ## sequence of zero or more characters, "?" will match any single
883 ## character, "[seq]" will match any character in seq, and "[!seq]"
884 ## will match any character not in seq.
885 ##
886 ## *) Tests are performed in sequence. The first match will terminate the
887 ## testing. This allows for more complex allow/deny patterns.
888 ##
889 ## Tests are case-sensitive.
890 ##
891 ## NOTE: Again, this is for the hiding of modules within repositories, *not*
892 ## for the hiding of repositories (roots) themselves.
893 ##
894 ## Some examples:
895 ##
896 ## Disallow "example" but allow all others:
897 ## forbidden = example
898 ##
899 ## Disallow "example1" and "example2" but allow all others:
900 ## forbidden = example1, example2
901 ##
902 ## Allow *only* "example1" and "example2":
903 ## forbidden = !example1, !example2
904 ##
905 ## Forbid modules starting with "x":
906 ## forbidden = x*
907 ##
908 ## Allow modules starting with "x" but no others:
909 ## forbidden = !x*
910 ##
911 ## Allow "xml", forbid other modules starting with "x", and allow the rest:
912 ## forbidden = !xml, x*, !*
913 ##
914 #forbidden =
915
916 ##---------------------------------------------------------------------------
917 [authz-forbiddenre]
918
919 ## The "forbiddenre" authorizer forbids access to repositories and
920 ## repository paths by comparing a list of regular expressions
921 ## (separated by commas) against paths consisting of the repository (or
922 ## root) name plus the path of the versioned file or directory to be
923 ## tested. For example, to see if the user is authorized to see the
924 ## path "/trunk/www/index.html" in the repository whose root name is
925 ## "svnrepos", this authorizer will check the path
926 ## "svnrepos/trunk/www/index.html" against the list of forbidden
927 ## regular expressions. Directory paths will be terminated by a forward
928 ## slash.
929 ##
930 ## Like the "forbidden" authorizer...
931 ##
932 ## *) The "!" can be used before a module to explicitly state that it
933 ## is NOT forbidden. Whenever this form is seen, then all modules will
934 ## be forbidden unless one of the "!" modules match.
935 ##
936 ## *) Tests are performed in sequence. The first match will terminate the
937 ## testing. This allows for more complex allow/deny patterns.
938 ##
939 ## Unlike the "forbidden" authorizer, you can can use this to hide roots, too.
940 ##
941 ## Some examples:
942 ##
943 ## Disallow files named "PRIVATE", but allow all others:
944 ## forbiddenre = /PRIVATE$
945 ##
946 ## Disallow the "hidden" repository, allowing all others:
947 ## forbiddenre = ^hidden(/|$)
948 ##
949 ## Allow only the "example1" and "example2" roots and the paths inside them,
950 ## disallowing all others (which can be done in multiple ways):
951 ## forbiddenre = !^example1(/|$), !^example2(/|$)/
952 ## forbiddenre = !^example[12](/|$)
953 ##
954 ## Only allow visibility of HTML files and the directories that hold them:
955 ## forbiddenre = !^([^/]+|.*(/|\.html))$
956 ##
957 #forbiddenre =
958
959 ##---------------------------------------------------------------------------
960 [authz-svnauthz]
961
962 ## The "svnauthz" authorizer uses a Subversion authz configuration file
963 ## to determine access to repository paths.
964
965 ## authzfile: Specifies the location of the authorization rules file
966 ## (using an absolute path).
967 ##
968 #authzfile =
969
970 ## force_username_case: Like the AuthzForceUsernameCase httpd.conf
971 ## directive, set this to "upper" or "lower" to force the normalization
972 ## to upper- or lower-case, respectively, of incoming usernames prior
973 ## to comparison against the authorization rules files. Leave the
974 ## option unset to preserve the username case.
975 ##
976 #force_username_case =
977
978 ##---------------------------------------------------------------------------

  ViewVC Help
Powered by ViewVC 1.1.2