The SVN (Subversion) Macro for Confluence is a light-weight Confluence plugin that allows easy integration of SVN files into Confluence. The integration is implemented either via embedding file content into a Confluence page or by attaching a list of files to a page and offering them for download.
These features are useful if you are using Subversion to store e.g. configuration or properties files. In the meantime, you want to offer non-technical readers to have an insight to the current files stored in SVN. This is where this plugin comes into play.
The plugin consists of three major areas: the embedder macro, the attacher macro and the global configuration screen. The configuration must take place upfront. After installing the plugin, go to the global configuration of Confluence and search for the SVN Macro configuration. You can then configure multiple connections to SVN repositories with an optional username-password authentication.
A proper configuration for e.g. three repositories could look like this:
To use the embedding function, go to a page, edit it and add the SVN Macro using the Confluence Macro browser. Search for SVN embed:
Next, configure the plugin by selecting a defined SVN repository connection. Then enter the path to the file which shall be embedded into the Confluence page, e.g. lint.xml:
The result of an embedded file looks like this:
To use the attcher function, go to a page, edit it and add the SVN Macro using the Confluence Macro browser. Search for SVN attach:
Next, configure the plugin by selecting a defined SVN repository connection. Then enter the paths to the files which shall be attched to the Confluence page. The single files need to be semicolon-separated, e.g. lint.xml; AndroidManifest.xml:
The result of a list of attached files looks like this: