Produce simple-minded graphical images of the structure of XML Schema files

Description

This plugin produces a graphical depiction of the data structure defined by an ​XML Schema (XSD) file.

Input files can be source files in an SVN repository, attachements to tickets or placed in the Trac server file system.

Output is as indicated in this example:

Assumptions

The current version assumes that an XSD file contains exactly one ComplexType definition at top level.

Bugs/Feature Requests

Existing bugs and feature requests for TracXsdPlotMacro are here.

If you have any issues, create a new ticket.

defect	0 / 2
enhancement	6 / 7
task	1 / 1

Download

Download the zipped source from here.

Source

You can check out TracXsdPlotMacro from here using Subversion, or browse the source​ with Trac.

Installation

General instructions on installing Trac plugins can be found on the TracPlugins page.

Requirements:

• ImageMagick must be installed.
• ElementTree must be installed for XSD parsing.

Enable the plugin as follows in your trac.ini file:

[components]
tracxsdplot.* = enabled

Tested with Trac 1.0.6 on Linux. Older Trac versions cannot access specific source file revisions.

Configuration

To access and convert files in the server's file system, set these in trac.ini:

[tracxsdplot]
file.prepath = /relative/entry/directory
file.preurl = http://example.com/entrydir

The plugin contains functionality that allows command-line usage as well:

/path/to/plugin/xsd2svg XSDFILE --outfile=OUTFILE

Usage

[[XsdPlot(schema.xsd,width=400,page=100,caption="Page 100 from Book Example")]]
[[XsdPlot(source:repo/schema.xsd@10,width=600,caption="SVG-image from repository in version 10")]]
[[XsdPlot(ticket:1:schema.xsd)]]

The Location of the resource (first parameter) can be an attachment (to a wikipage, or a ticket) a file in svn or a local file (keyword "file:").

Trac link	Alternatives	Comment
wiki	JustPageName	Attachment in wikipage
ticket	#1
source	browser,repos
file		remember configuration value file.prepath

Parameters:

Parameter	Value	Default
xsdfile	location of XSD file		required
width	width in pixel	600	must be absolute value
caption	caption under image	none
label	anchor to link to
cache	build once or each time	True	time consumption or changing vectorgraphics
align	left|right	nothing

Recent Changes

17313 by thenor on 2018-12-05 19:37:34

Fix #13440 - whitespace removed and #13506 - allow multiple toplevel elements. And code cleaned a bit up but is still very messy.

15672 by thenor on 2016-07-27 08:24:33

fix #12585, #12586, #12669, #12783. Bump version to 1.1

14868 by thenor on 2015-08-10 20:45:16

Fix 12475: Added 3-clause BSD licence and other metadata according to DevGuide

(more)

Author/Contributors

Author: thenor
Maintainer: Theodor Norup
Contributors:

Credits

Thanks to ursaw for most of the macro argument parsing and trac infrastructure that is taken from PdfImagePlugin.