Debian Codegraph @

trang/doc/trang.html

raw
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 &#169; 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>