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.
- Informations about current revision, author, date and log message
- Admin panel for easy usage
See it in action on my site. (Sorry, text is german only… but you get the catch!)
To install the plugin follow the listed steps:
- Download the package
- Decompress the archive and upload it to /wp-content/plugins/ on your webspace
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Change the settings (submenu of the options) according to your machine setup
- For the full experience you have to install WebSVN and add your repositories (this provides the download ability)
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.
The current version of my program is [svn:head@/home/user/svn/program].
The current version of my program is [svn:head@program].
This is only working when the svn base path is set to /home/user/svn in the admin panel.
As of version 0.7 there are additional attributes which you can set for each repository inside the tag:
With a specified WebSVN category. This also works with the full path tag.
A subdirectory for the WebSVN download. This does not work with full path tag.
Or a combination of both…
Please note that in version 0.7.1 the separator for category and repository changed from a dot (.) to an asterisk (*) to allow paths with dots in it. (Bugfix for Josh, thanks for reporting!)
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.
Frequently Asked Questions
Q: Is the plugin compatible with WordPress 3.0.
A: As far as I can see it is. (Tested with WP 3.0.1)
Q: Where can I report bugs?
A: Feel free to leave a comment below.
- 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.
- Subdirectory download is only possible if the full path tag isn’t in use.
- The separator for category and repository changed from a dot (.) to an asterisk (*) to allow paths with dots in it. (Bugfix for Josh, thanks for reporting!)
- Added possibility to specify WebSVN category and subdirectory for each svn tag.
- First public version.