Version 5 (modified by 8 years ago) (diff) | ,
---|
Contents
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.
Attachments (2)
-
trac-hacks-example.png (88.2 KB) - added by 9 years ago.
Example image
-
trac-hacks-example_1.1.png (133.1 KB) - added by 8 years ago.
Example plot from V1.1
Download all attachments as: .zip