NAME

lcfg-websvn - The LCFG websvn component

VERSION

This documentation refers to lcfg-websvn version 0.1.0

DESCRIPTION

This component manages the configuration for WebSVN. The component supports the majority of the possible options. In particular there is a focus on supporting the configuration of individual subversion repository views.

RESOURCES

basedir

The base directory where the websvn instance is installed. This defaults to /var/www/websvn

templates

The default templates scheme to be used for the site. This defaults to "calm". This can be overridden on an individual repository basis, see below. Bad things will happen if you choose a scheme name for which no templates are installed.

treeindex

The index page containing the projects may either be displayed as a flat view (the default), where grouped repositories are displayed as "GroupName.RepName" or as a tree view. In the case of a tree view, you may choose whether the entire tree is open by default. The default value for this resource is '' (empty string) which indicates the tree index is not required. If you want a tree-index you can set this to 'open' or 'closed' to control the default view.

useflatview

This is a boolean value which controls whether WebSVN displays a tree view or a flat view of the current directory. A flat-view may make the display load faster. By default this is false.

usemultiviews

This is a boolean value which is used to control whether MultiView should be used to access the repositories. The websvn directory will need to have Multiviews turned on in the Apache configuration, and you will need to configure the wsvn.php script. The default for this is false.

allowdownload

A boolean value which controls whether or not the default site policy is to allow tarball downloads. This can be overridden on an individual repository basis, see below. The default value is false.

colourisation

This controls which system should be used for colourising your file listings. The default is 'geshi', you can also use 'enscript' if you have version 1.6 or higher installed.

repositories

A list of subversion repositories.

displayname_tag

By default the display name is the same as the tag name for the subversion repository. If you want characters which cannot be in an LCFG resource name (e.g. spaces) then set this resource for your repository.

url_tag

This is the URL for the subversion repository, it can be either a file:// or http:// protocol. Performance is much better on local repositories. For a remote repository you will probably need to supply the username and password as well (see below).

group_tag

You may optionally supply a group name for a repository, this will control how they are listed on the front page.

user_tag

The username for accessing this repository.

pass_tag

The password for accessing this repository.

authz_tag

The subversion authorization file for this repository.

templates_tag

The templates scheme to be used for this specific subversion repository. If not set the default scheme will be used.

allowdownload_tag

This is a boolean value which controls whether or not it is possible to download tarballs for this specific repository. If not set the site default will be used.

mindownloadlevel

This is an integer which can be used to control the level in the repository at which users are allowed to download tarballs. A value of zero will allow downloading from the root. A value of 1 will allow downloading of directories from the next level up. This can be useful if you have a trunk, tags, branches structure and want to prevent users downloading the entire trunk or tags tree.

SEE ALSO

WebSVN website - http://websvn.tigris.org/

PLATFORMS

This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.

ScientificLinux5

AUTHOR

Stephen Quinney <squinney@inf.ed.ac.uk>

LICENSE AND COPYRIGHT

 Except where otherwise explicitly stated all copyright:

(C) 2008-2009 University of Edinburgh. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.