ReposStyle    

A free open source stylesheet for the Subversion index web page. The XSLT and CSS is fully customizable. There is icons for folders and many different filetypes. Install Repos Style as it is or use is as a sample XSLT to design your own. A simple log viewer is also included.

You need the repository configured in Apache. See the Subversion book. Repos Style is installed using the SVNIndexXSLT directive. To use the log viewer you need PHP.

The advantages of using XSLT instead of a viewer like ViewSVN is that it is lightweight and that you use the real URLs in the directory listing. There is no viewer for older revisions, but you can customize the stylesheet to link to other tools.

View samples here.

From

 plain text svn index

to

 colorful index with icons

in five minutes

Start by verifying that your http repository is up and running.

  1. Download Repos Style zip
  2. Unzip to the document root of the repository host (this creates a folder /repos-web)
  3. In the Apache config, set SVNIndexXSLT "/repos-web/view/repos.xsl"
  4. Reload Apache
  5. Check your http URL again
  6. Optionally set up the Very Simple Logviewer; see this mailing list entry

How to change install path

How to customize

Check the configuration section in the XSL files.

It is good practice to have a start page on the repository host with links to each project's trunk, branches, tags folder(s). That way you don't need to give read access to repository root (which would be inherited to new projects by default). Repos Style XSLT has a startpage property to set a URL for the toolbar's "home" button.

To customize the menu, edit the commandbar section of the xsl. To customize the buttons displayed on each row, edit the actions section of the dir and file xsl templates.

See the development section on how to contribute changes.

Download

Get a zipped distribution from the » download « folder.

Release History

  1. 2009-03-132.0 Added support for multiple repositories (SVNParentPath) on Subversion 1.5 or later. Repos Style still supports Subversion 1.0 and later for single repository configuration (SVNPath).
  2. 2008-03-271.5 Fixed a path display issue with leading slash and SVNParentPath's Collection of Repositories. Commented out the trailing slash.
  3. 2008-02-031.4 Fixed an issue with the repository CSS in IE6.
  4. 2008-01-091.3 Renamed default install folder to repos-web to avoid conflict with common svn parent path /repos. In the listings: changed from divs to the more semantically correct ul/li.
  5. 2007-10-091.2 Improved performance in path (breadcrumbs) template. Added detection of trunk+branches+tags folders, allowing special styling through CSS. Added a folder icon with a lock symbol for tags. The log viewer now displays errors from the svn command.
  6. 2007-05-261.1 Documentation, build system and samples, no code changes.
  7. 2007-05-221.0 Initial undocumented release.

Development

This project is open source. You chan check out the contents at labs.repos.se. It is Apache 2.0 license, while the icons are Creative Commons ShareAlike 2.0. At present the maintainers are Staffan Olsson and Ermin Catic.

For support and discussion please use the mailing list.