wiki:TracXsdPlotMacro

Produce 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, attachments to tickets or placed in the Trac server file system.

Output is as indicated in this example:

Example plot from V1.1

Bugs/Feature Requests

Existing bugs and feature requests for TracXsdPlotMacro are here.

If you have any issues, create a new ticket.

enhancement

4 / 4

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

[tracxsdplot]
file.prepath = /relative/entry/directory
file.preurl = http://example.com/entrydir
png-density = 600
colour.element = #D3D3D3
colour.complextype = #B3B3B3
colour.container = #FFFFFF
colour.stroke = #2F4F4F

The trac.ini attributes have the following meaning:

file.prepath Path prefix for local files
file.preurl URL prefix
png-density pixel density for generated PNG images (used as parameter to ImageMagick)
colour.element RGB colour used for <xs:element>
colour.complextype ... for <xs:complexType>
colour.container ... for <xs:sequence>, <xs:all>, <xs:choice>
colour.stroke ... for box frames

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

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
14866 by thenor on 2015-08-10 14:21:13
initial, primitive version
(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.

Last modified 17 months ago Last modified on Jul 27, 2016, 5:23:15 PM

Attachments (2)

Download all attachments as: .zip