trang(1)

💖 trang(1) — the manual, but make it make sense 💖

okay bestie, welcome to trang, a General Commands Manual icon. she converts between different schema languages for XML, and honestly? she's serving range. let's get into it ✨

---

🌸 NAME 🌸

trang — convert between different schema languages for XML

---

✨ SYNOPSIS ✨

trang [-I rng|rnc|dtd|xml] [-O rng|rnc|dtd|xsd] [-i input-param] [-o
output-param] input-file ...  output-file

like, that's the whole vibe in one line. read it slowly, she's worth it 🫶

---

🦋 DESCRIPTION 🦋

so trang takes as input a schema written in any of these formats:

• RELAX NG (XML syntax)
• RELAX NG (compact syntax)
• XML 1.0 DTD

and she produces as output a schema written in any of these formats:

• RELAX NG (XML syntax)
• RELAX NG (compact syntax)
• XML 1.0 DTD
• W3C XML Schema

and listen — Trang can also infer a schema from one or more example XML documents. yes, she can just look at your little XML babies and reverse-engineer the whole rulebook. main character behaviour, no cap 👑

Under the hood, Trang uses an internal representation based on RELAX NG. For each supported input format, there's an input module that converts a schema in that input format into this internal representation. For each supported output format, there's an output module that converts the internal representation into a schema in that output format. so basically it's a relay race and the baton is RELAX NG. and because of that: any supported input format can be translated to any supported output format. slay 💅

Trang requires two command-line arguments: the first is the URI or filename of the schema to be translated; the second is the output filename.

Trang infers the input and output modules to be used from the extension of input and output filenames as follows:

• .rng — RELAX NG (XML syntax)
• .rnc — RELAX NG (compact syntax)
• .dtd — XML 1.0 DTD
• .xsd — W3C XML Schema
• .xml — XML documents (used as examples from which to infer a schema)

This inference can be overridden using the -I and -O options. she'll guess, but you can absolutely correct her, and she won't be offended 🎀

When the input is XML documents used as examples to infer a schema, more than one input file may be specified as arguments. All the input files are specified before the output file. so: examples first, destination last. order matters, bestie, don't fight it 🌈

---

💅 OPTIONS 💅

• -I rng|rnc|dtd|xml — Specifies which input module to use.
• -O rng|rnc|dtd|xsd — Specifies which output module to use.
• -i input-param
• -o output-param — Specifies a parameter for an input (-i) or output (-o) module. The -i and -o options may be used multiple times in order to specify multiple parameters. There are two kinds of parameter: boolean parameters and string-valued parameters. A string-valued parameter is specified using the form name=value. A boolean parameter is specified using the form name or no-name. The applicable parameters depend on the particular input and output module. For details, see the HTML documentation.

ngl the -i and -o parameters are the "iykyk" part of this manual — which ones actually apply depends entirely on which input and output module you're running, so check the HTML documentation before you start guessing 💀

---

🌟 SEE ALSO 🌟

• jing(1)
• Trang Manual
• http://relaxng.org

---

👑 AUTHOR 👑

James Clark (jjc@jclark.com)

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

---

and that's the whole page, bestie 🧚 this was version @VERSION@ of the trang manual page, from the General Commands Manual. go forth and convert schemas, you absolute icon 🍓💜