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:

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)]]

Possible trac links for input files/resources:

Trac link	Alternatives	Comment
wiki:	JustPageName	Wiki page attachment
ticket:	#1	Ticket attachment
source:	browser,repos	File stored in subversion
file:		Local file. Path prefix read from file.prepath in trac.ini

XSD layout selectiveness control parameters:

Parameter	Value	Default
top-element	select specific top XSD element of plot	assumes file to contain exactly one XSD root element. Otherwise the first element encountered will be plotted.
depth	maximum depth counted in elements	infinity
stop-list	Pipe-separated list of XSD element names where recursive descent shall stop	empty

Other parameters:

Parameter	Value	Default	Note
img-type	'png' or 'svg'	svg	case INsensitive
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 vector graphics
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.