| 1 |
<html xmlns="http://www.w3.org/1999/xhtml"> |
| 2 |
<head> |
| 3 |
<title>Trang</title> |
| 4 |
</head> |
| 5 |
<body> |
| 6 |
<h1>Trang</h1> |
| 7 |
<h2>Multi-format schema converter based on RELAX NG</h2> |
| 8 |
|
| 9 |
<p>Copyright © 2002, 2003, 2008 Thai Open Source Software Center |
| 10 |
Ltd</p> |
| 11 |
|
| 12 |
<p>See the file <a href="copying.txt">copying.txt</a> for copying |
| 13 |
permission.</p> |
| 14 |
|
| 15 |
<h3>Version @VERSION@</h3> |
| 16 |
|
| 17 |
<p>Trang converts between different schema languages for XML. It |
| 18 |
supports the following languages:</p> |
| 19 |
|
| 20 |
<ul> |
| 21 |
<li>RELAX NG (XML syntax)</li> |
| 22 |
<li>RELAX NG compact syntax</li> |
| 23 |
<li>XML 1.0 DTDs</li> |
| 24 |
<li>W3C XML Schema</li> |
| 25 |
</ul> |
| 26 |
|
| 27 |
<p>A schema written in any of the supported schema languages can be |
| 28 |
converted into any of the other supported schema languages, except |
| 29 |
that W3C XML Schema is supported for output only, not for input.</p> |
| 30 |
|
| 31 |
<p>Trang can also infer a schema from one or more example XML |
| 32 |
documents.</p> |
| 33 |
|
| 34 |
<p>Trang is constructed around an RELAX NG object model designed to |
| 35 |
support schema conversion. For each schema language supported for |
| 36 |
input, there is an input module that can convert from the schema |
| 37 |
language into this internal object model. Similarly, for each schema |
| 38 |
language supported for output, there is an output module that can |
| 39 |
convert from the internal object model in the schema language.</p> |
| 40 |
|
| 41 |
<p>Trang aims to produce human-understandable schemas; it tries for a |
| 42 |
translation that preserves all aspects of the input schema that may be |
| 43 |
significant to a human reader, including the definitions, the way the |
| 44 |
schema is divided into files, annotations and comments.</p> |
| 45 |
|
| 46 |
<p>Trang has a command-line user interface. It has no graphical user |
| 47 |
interface.</p> |
| 48 |
|
| 49 |
<h2>Download</h2> |
| 50 |
|
| 51 |
<p>The |
| 52 |
file <a href="http://jing-trang.googlecode.com/files/trang-@[email protected]" |
| 53 |
>trang-@[email protected]</a> contains Trang version @VERSION@ including |
| 54 |
binaries, source code and documentation. It requires a Java runtime |
| 55 |
compatible with the Java 2 Platform, Standard Edition (J2SE) version 5 |
| 56 |
(or any later version), such as the Java Runtime Environment (JRE), |
| 57 |
which can be |
| 58 |
downloaded <a href="http://java.sun.com/j2se/downloads.html">here</a>.</p> |
| 59 |
|
| 60 |
<p>The latest version of Trang will aalways be available in |
| 61 |
the <a href="http://code.google.com/p/jing-trang/downloads/list">Downloads</a> |
| 62 |
section of the <a href="http://jing-trang.googlecode.com">project |
| 63 |
site</a>.</p> |
| 64 |
|
| 65 |
<h2>Further information</h2> |
| 66 |
|
| 67 |
<p>Detailed information about using Trang is in the <a |
| 68 |
href="trang-manual.html">manual</a>.</p> |
| 69 |
|
| 70 |
<p>Some background information on the conversion to W3C XML Schema is |
| 71 |
available in the <a href="convert-to-xsd-talk.html">slides</a> for a |
| 72 |
talk given a XML 2002.</p> |
| 73 |
|
| 74 |
<h2>Participate</h2> |
| 75 |
|
| 76 |
<p>Development of Trang, together |
| 77 |
with <a href="http://www.thaiopensource.com/relaxng/jing.html">Jing</a>, |
| 78 |
takes place in |
| 79 |
the <a href="http://jing-trang.googlecode.com">jing-trang project</a>, |
| 80 |
which is hosted on Google Code.</p> |
| 81 |
|
| 82 |
<p>If you find a bug or would like to request an enhancement, please |
| 83 |
create a new issue in |
| 84 |
the <a href="http://code.google.com/p/jing-trang/issues/list">Issues</a> |
| 85 |
section of the project site. You can talk with other users of Trang on |
| 86 |
the <a href="http://tech.groups.yahoo.com/group/rng-users/">rng-users</a> |
| 87 |
mailing list.</p> |
| 88 |
|
| 89 |
<p>If you want to make changes to Trang, you |
| 90 |
should <a href="http://code.google.com/p/jing-trang/source/checkout">check |
| 91 |
out</a> the source code from the project's Subversion repository. (The |
| 92 |
source code included in the Trang download is for reference purposes, |
| 93 |
and doesn't contain the supporting files, such as build scripts and |
| 94 |
test cases, that are needed for working conveniently with the source |
| 95 |
code.)</p> |
| 96 |
|
| 97 |
|
| 98 |
<h2>Related software</h2> |
| 99 |
|
| 100 |
<p>Trang's DTD input module uses <a |
| 101 |
href="http://www.thaiopensource.com/relaxng/dtdinst/">DTDinst</a>. |
| 102 |
The Trang distribution already includes the necessary parts of |
| 103 |
DTDinst, so there is no need to download DTDinst just in order to use |
| 104 |
Trang. DTDinst is also available as an independent program that |
| 105 |
outputs an XML representation of an XML DTD.</p> |
| 106 |
|
| 107 |
<p>The <a href="http://msv.dev.java.net/">Sun Multi-Schema |
| 108 |
Validator</a> includes the rngconv tool, which converts from a variety |
| 109 |
of different schema languages into RELAX NG. However, it is based on |
| 110 |
an object model which is designed to support validation, and so does |
| 111 |
not preserve aspects of the input schemas that are irrelevant for |
| 112 |
validation (such as the definitional structure).</p> |
| 113 |
|
| 114 |
<p>The <a href="http://www.brics.dk/schematools/">schematools</a> |
| 115 |
package does schema conversion based around a restricted subset of |
| 116 |
RELAX NG. It supports conversion from W3C XML Schema to RELAX NG.</p> |
| 117 |
|
| 118 |
<address><a href="mailto:[email protected]">James Clark</a></address> |
| 119 |
|
| 120 |
</body> |
| 121 |
</html> |