=== Subversion Informations ===
Contributors: ClydeFrog
Tags: svn, subversion, info, informations
Requires at least: 2.0
Tested up to: 2.8.3
Stable tag: 0.6

A plugin designed to provide informations about local SVN repositories.

== Description ==

Subversion Informations is a plugin for WordPress, designed to provide informations about local SVN repositories.
It can make use of WebSVN to offer the current version as a direct download.

To display information in your postings, you can make use of one of the new [svn:<element>@<repository>] tags.

Features

*   Informations about current revision, author, date and log message
*   Admin panel for easy usage

See it in action on [my site](http://bitrage.eu/scripts/bitlbee-manager/ "bitrage.eu"). (Sorry, text is german only... but you get the catch!)

== Installation ==

To install the plugin follow the listed steps:

1. Download the package
2. Decompress the archive and upload it to /wp-content/plugins/ on your webspace
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Change the settings (submenu of the options) according to your machine setup
5. For the full experience you have to install WebSVN and add your repositories (this provides the download ability)

== Usage ==

To display information about a SVN repository in one of your texts you just have to insert the [svn:<element>@<repository>] tag in the desired spot.

The element can be one of these:

*   *head* for the current revision
*   *author* for the username of the last contributer
*   *date* for the actual time of the last change
*   *log* for the user provided message
*   *box* for a predefined box containing all four of the above along with a download link (using WebSVN)

The repository can be either a full path (i.e. /home/user/svn/repo) or just the name of the repository (i.e. repo).
This of course is according to the settings in the admin panel where you have to set the base path of your repositories for the name-method to work.

Example:
`The current version of my program is [svn:head@/home/user/svn/program].`
or
`The current version of my program is [svn:head@program].`
if the svn base path was set to /home/user/svn in the admin panel.

If you want to show the full box, you better insert it between paragraphs and not in the middle of your text, as it will bust your format.
Also it is a good idea to use a wider theme than the default one to get the best formated box.
The result is shown in the screenshot section.

== Screenshots ==

1. Example text with every five elements
2. Admin panel

== Frequently Asked Questions ==

None so far

== Limitations ==

The Plugin is limited quite a bit in its current form, as there is only support for the current (HEAD) revision.
Also the use of WebSVN is mandatory to get a working download link.
Although the category feature of WebSVN is supported, it is only possible to use a default one for all used repositories.
The download behavior is still a download of the whole repository. An integration of subdirectories is planned.