| 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 |
##---------------------------------------------------------------------------
|