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.

A not namespace-valid documentEditing Documents | 56When Check document form is performed the following error is raised:The prefix "x" for element "x:y" is not bound.Also the files contained in the current project and selected with the mouse in the Project view can be checked forwell-formedness with one action available on the popup menu of the Project view :Validating <strong>XML</strong> Documents Against a SchemaCheck Well-Formedness.A Valid <strong>XML</strong> document is a Well Formed <strong>XML</strong> document, which also conforms to the rules of a schema which definesthe legal elements of an <strong>XML</strong> document. The schema type can be: <strong>XML</strong> Schema, Relax NG (full or compact syntax),Schematron, Document Type Definition (DTD), or Namespace-based Validation Dispatching Language (NVDL).The purpose of the schema is to define the legal building blocks of an <strong>XML</strong> document. It defines the document structurewith a list of legal elements.The <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> Validate document function ensures that your document is compliant with therules defined by an associated DTD, <strong>XML</strong> Schema, Relax NG, or Schematron schema. <strong>XML</strong> Schema or Relax NGSchema can embed Schematron rules. For Schematron validations, it is possible to select the validation phase.Marking Validation Errors and WarningsA line with a validation error or warning will be marked in the editor panel by underlining the error region with a redcolor. Also a red sign will mark the position in the document of that line on the right side ruler of the editor panel. Thesame will happen for a validation warning, only the color will be yellow instead of red.The ruler on the right side of the document is designed to display the errors and warnings found during the validationprocess and also to help the user to locate them more easily. The ruler contains the following areas:• Top area containing a success validation indicator that will turn green in case the validation succeeded or red otherwise.• Middle area where the error markers are depicted in red . The number of markers shown can be limited by modifyingthe setting Window > Preferences > oXygen > Editor > Document checking > Maximum number of problemsreported per document .Clicking on a marker will highlight the corresponding text area in the editor. The error message is displayed both inthe tool tip and in the error area on the bottom of the editor panel.Status messages from every validation action are logged into the Console view.If you want to see all the validation error messages grouped in a view you should run the action Validate which isavailable both on the toolbar and on the <strong>XML</strong> menu. This action collects all error messages in the Problems view ofthe Eclipse platform if the validated file is in the current workspace or in a custom <strong>Oxygen</strong> view called Errors if thevalidated file is outside the workspace.Validation Example - A DocBook Validation ErrorIn the following DocBook 4 document the content of the listitem element does not match the rules of the DocBook4 schema, that is docbookx.dtd.Article TitleSection1 Title

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

Saved successfully!

Ooh no, something went wrong!