24.08.2015 Views

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Editing Documents | 58Figure 29: Automatic Validation on the Edited DocumentCustom ValidatorsIf you need to validate the edited document with other validation engine than the built-in one you have the possibilityto configure external validators in the <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> user preferences. After such a custom validator isproperly configured it can be applied on the current document with just one click on the Custom Validation Enginestoolbar. The document is validated against the schema declared in the document.Some validators are configured by default but they are third party processors which do not support the output messageformat of <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> for linked messages:• LIB<strong>XML</strong> - Included in <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> (Windows edition only). It is associated to <strong>XML</strong> Editor. It isable to validate the edited document against <strong>XML</strong> Schema, Relax NG schema full syntax, internal DTD (includedin the <strong>XML</strong> document) or a custom schema type. <strong>XML</strong> catalogs support (the --catalogs parameter) and XIncludeprocessing (--xinclude) are enabled by default in the preconfigured LIB<strong>XML</strong> validator. The --postvalid parameteris also set by default which allows LIB<strong>XML</strong> to validate correctly the main document even if the XInclude fragmentscontain IDREFS to ID's located in other fragments.For validation against an external DTD specified by URI in the <strong>XML</strong> document, the parameter --dtdvalid ${ds} mustbe added manually to the DTD validation command line. ${ds} represents the detected DTD declaration in the <strong>XML</strong>document.Caution: Known problem: file paths containing spaces are not handled correctly in the LIB<strong>XML</strong> processor.For example the built-in <strong>XML</strong> catalog files of the predefined document types (DocBook, TEI, DITA, etc)are not handled by LIB<strong>XML</strong> if <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> is installed in the default location on Windows(C:\Program Files) because the built-in <strong>XML</strong> catalog files are stored in the frameworks subfolder of theinstallation folder which in this case contains at least one space character in the file path.Attention:On Mac OS X if the full path to the LIB<strong>XML</strong> executable file is not specified in the Executable path textfield, some errors may occur on validation against a W3C <strong>XML</strong> Schema like:Unimplemented block at ... xmlschema.cThese errors can be avoided by specifying the full path to the LIB<strong>XML</strong> executable file.• Saxon SA - Included in <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> . It is associated to <strong>XML</strong> Editor and XSD Editor. It is able tovalidate <strong>XML</strong> Schema schemas and <strong>XML</strong> documents against <strong>XML</strong> Schema schemas. The validation is done according

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!