From 28044805258c38ee407c1382fddffa09fb9f309f Mon Sep 17 00:00:00 2001 From: Jirka Kosek Date: Sat, 27 Oct 2007 21:48:12 +0000 Subject: [PATCH] Some additions for a new release --- docbook/relaxng/docbook/howto/TODO | 29 +++++++++++ docbook/relaxng/docbook/howto/howto.xml | 64 ++++++++++++++++++++++--- 2 files changed, 86 insertions(+), 7 deletions(-) create mode 100644 docbook/relaxng/docbook/howto/TODO diff --git a/docbook/relaxng/docbook/howto/TODO b/docbook/relaxng/docbook/howto/TODO new file mode 100644 index 000000000..92cc9c551 --- /dev/null +++ b/docbook/relaxng/docbook/howto/TODO @@ -0,0 +1,29 @@ +# -*- org -*- +* TODO Add information about referencing schemas used in customizations +Hi, + +I am wondering if there is an "official URI" for DocBook 5, especially for +using it inside an include element. + +Consider someone is customizing DocBook 5 and want to include the RELAX NG +Schema: + + include "docbook.rnc" { ... } + ^^^^^^^^^^^ + +Sometimes I see a path here which I consider bad style because it is +platform dependend. How can I reference to the DocBook 5 Schema +officially? Are there any plans on this? Or is the DocBook TC consider +this out of scope? I couldn't find anything in this regard in the DocBook +V5.0 Howto. + + +Thanks, +Tom + +-- Thomas Schraitle +* DONE Update links to CR4 +* TODO Add link to DocBook+ITS section in ITS BP document + +...and to other existing DB5 customizations +* TODO Add more references (NVDL, ...) diff --git a/docbook/relaxng/docbook/howto/howto.xml b/docbook/relaxng/docbook/howto/howto.xml index 6e35af8eb..da22dbc43 100644 --- a/docbook/relaxng/docbook/howto/howto.xml +++ b/docbook/relaxng/docbook/howto/howto.xml @@ -1,6 +1,6 @@ + ]>
-2007-12-25 +2007-10-28 2006-10-22 2006-05-16 2006-03-01 @@ -221,6 +221,12 @@ that don't support RELAX NG. Authors are encouraged to switch to RELAX NG based tools as soon as possible, or at least to validate documents against the RELAX NG schema before further processing. +Some document constrainst can't be expressed in schema languages +like RELAX NG or W3C XML Schema. To check for these additional +constraints DocBook V5.0 uses Schematron. It is recommended to +validate your document not only against RELAX NG schema but also +against Schematron schema. +
Where to get the schemas @@ -246,6 +252,10 @@ available at the following locations: W3C XML Schema + +Schematron schema with additional checks + + These schemas are also available from the mirror at @@ -436,9 +446,17 @@ documents. If you are not using a RELAX NG based validating editor when you create documents, we strongly recommend that you validate your -documents before processing them. Only after successful validation you can be -sure that your document is really DocBook V5.0 and that processing -tools will be able to process it correctly. +documents against RELAX NG and Schematron schemas before processing +them. Only after successful validation you can be sure that your +document is really DocBook V5.0 and that processing tools will be able +to process it correctly. + +For validation you can use tools that support simultaneous RELAX NG and +Schematon validation or you can use NVDL to orchestrate validation to +those two schemas. + +
+Using RELAX NG and Schematron You can find a list of RELAX NG validators at . It is best to use @@ -483,6 +501,38 @@ RELAX NG schema with embedded Schematron rules.
+
+Using NVDL + +NVDL is a metaschema language which can send one document to +validation against several schemas. DocBook V5.0 comes with NVDL +schema which defines that DocBook documents should be validated +against both RELAX NG and Schematron schema. + +You can find a list of NVDL validators at . The following procedure shows how to +install and use oNVDL +validator. + + + +Download onvdl-20070517.zip. + + +Unpack the downloaded file into an arbitrary directory. + + +Validate your document using the following command: +java -jar /path/to/oNVDL/bin/onvdl.jar /path/to/docbook.nvdl document.xml + + + +
+ +
+
Processing DocBook V5.0 @@ -514,8 +564,8 @@ completely transparent to the user. If you are processing DocBook V5.0 documents, the only difference is that you will see the following additional message: -Stripping NS from DocBook 5/NG document. -Processing stripped document. +Note: namesp. cut : stripped namespace before processing +Note: namesp. cut : processing stripped document Although you can successfully use the existing stylesheets to process DocBook V5.0, there are some limitations and unsupported -- 2.40.0