# concrete-relaxng-parser: A parser driven by a standard RELAX NG schema with concrete syntax extensions.

[ parsing, program, xml ] [ Propose Tags ]

This package exports a parser executable named parse-concrete. The executable takes two arguments, the target RELAX NG schema filename and the input filename. The input must be well-formed XML. The output of the parser is either an error or XML conforming to the schema.

If the input XML already conforms to the target schema, the parser acts as an ordinary RELAX NG validator. If not, it attempts to insert the missing element tags and to parse the input text nodes into XML elements. The target schema can be enriched by concrete syntax extensions, syntactically compatible with standard RELAX NG, to drive the parsing process.

The included sample RELAX NG schema xhtml-concrete.rng is an extension of, and must be used together with, James Clark's modularized RELAX NG schema for XHTML, which can be downloaded from http://www.thaiopensource.com/relaxng/xhtml/. Here is an example session:

$cat <<END >test.xhtml.short<?xml version="1.0" encoding="UTF-8"?> <html xmlns="http://www.w3.org/1999/xhtml"> Title A paragraph may contain more than one line. Use *four* (that was emphasized) hyphens to draw a horizontal line: ---- Unnumbered lists are like * item a * item b Numbered lists are like * item a * item b </html> END$ parse-concrete xhtml-concrete.rng test.xhtml.short | tee test.xhtml
<?xml version="1.0" encoding="UTF-8"?>
$parse-concrete xhtml-concrete.rng test.xhtml | diff test.xhtml -$