From: Mauritz Jeanson Date: Sat, 24 Nov 2007 16:46:37 +0000 (+0000) Subject: Some punctuation, spelling, and wording fixes. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0d4e72110168ad1ecc959382ab276fe8b94ff13c;p=docbook-dsssl Some punctuation, spelling, and wording fixes. --- diff --git a/docbook/relaxng/docbook/howto/howto.xml b/docbook/relaxng/docbook/howto/howto.xml index 5d4d24de3..8cdd7e5a6 100644 --- a/docbook/relaxng/docbook/howto/howto.xml +++ b/docbook/relaxng/docbook/howto/howto.xml @@ -45,7 +45,7 @@ also section devoted to conversion of legacy documents from DocBook 4.x to DocBook V5.0. At the time of this writing the current version of DocBook V5.0 -was &version;. However almost all information in this document is +was &version;. However, almost all information in this document is general and it is applicable to any newer version in DocBook V5.0 series. @@ -296,7 +296,7 @@ process content stored in DocBook V5.0. Because DocBook is an XML based format and XML is a text based format, you can use any text editor to create and edit DocBook V5.0 -documents. However using dumb editors like Notepad is +documents. However, using dumb editors like Notepad is not very productive. You will do better if you use an editor that supports XML. Although there are DTD and W3C XML Schemas available for DocBook V5.0, which means you can use any editor that works with DTDs @@ -454,7 +454,7 @@ 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 +Schematron validation, or you can use NVDL to orchestrate validation using those two schemas.
@@ -465,7 +465,8 @@ xl:href="http://relaxng.org/#validators"/>. It is best to use validators with support for embedded Schematron rules inside RELAX NG schemas. Schematron is a rule-based validation language which is used to impose additional constraints on DocBook documents. Schematron rules -assert conditions which cannot be expressed in a pure RELAX NG schema. +assert conditions which are impossible or difficult to express +in a pure RELAX NG schema. Sun Multi-Schema XML Validator (MSV) is able to validate an XML @@ -506,10 +507,10 @@ 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 +NVDL is a metaschema language which can send a document to +validation against several schemas. DocBook V5.0 comes with a NVDL schema which defines that DocBook documents should be validated -against both RELAX NG and Schematron schema. +against both RELAX NG and Schematron schemas. You can find a list of NVDL validators at . The following procedures show how to @@ -546,9 +547,9 @@ xl:href="http://sourceforge.net/project/showfiles.php?group_id=164464"/>. Modify file jnvdl.bat (or jnvdl.sh on Unix based systems) to include switch directly after java command. -On Windows systems validate your document using the following command: +On Windows systems, validate your document using the following command: /path/to/jnvdl/jnvdl -nt -s /path/to/docbook.nvdl document.xml -On Unix systems validate your document using the following command: +On Unix systems, validate your document using the following command: /path/to/jnvdl/jnvdl.sh -nt -s /path/to/docbook.nvdl document.xml @@ -575,7 +576,7 @@ versions of the stylesheets are also able to process DocBook V5.0 with some limitations. You can process DocBook V5.0 documents with the DocBook XSL -stylesheets exactly the same way as you process DocBook V4.x documents. +stylesheets in exactly the same way as you process DocBook V4.x documents. You do not need special software, you can stick to your preferred XSLT processor, be it Saxon, xsltproc, Xalan or whatever else (but see the note about the lost base URI below). @@ -583,8 +584,8 @@ the note about the lost base URI below). During document processing, the stylesheets strip namespaces from DocBook V5.0 to get a document which will be very similar to DocBook V4.x. This is necessary because from the XSLT -point of view elements from different namespaces are distinct and can -not be easily processed by the same set of templates. This process is +point of view, elements from different namespaces are distinct and cannot +be easily processed by the same set of templates. This process is 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: @@ -637,7 +638,7 @@ namespaced (DocBook 5) documents.
XSLT 2.0 based re-implementation -XSLT 1.0 is missing some important features. To work around +XSLT 1.0 is missing some important features. To work around these missing features, the current DocBook XSL stylesheets use some implementation-specific extensions. XSLT 2.0 adds many new and previously missing features into the language. @@ -975,7 +976,7 @@ that allows you to edit markup “in the raw”. to preserve with some unique string. For example, if you want to preserve “∏” references, you could replace them all with “[[[Product]]]” (assuming that the string -“[[[Product]]]” doesn't occur anywhere else in your document). +“[[[Product]]]” doesn't occur anywhere else in your document). Copy the document type declaration off of your document and save @@ -1108,7 +1109,7 @@ linkend="convert4to5"/>. - Names have two or more parts, separated dots . + Names have two or more parts, separated by dots . @@ -1274,15 +1275,15 @@ linkend="convert4to5"/>. The href attribute of the include element points to the location of the standard DocBook V5.0 - schema.Examples below use - docbook.rng as schema location. If you want - to create portable schema customization you should use standard + schema.The examples in this section use + docbook.rng as the schema location. If you want + to create a portable schema customization you should use a standard web-accessible location like http://docbook.org/xml/&version;/rng/docbook.rng and then use XML catalogs to resolve this location to your local copy of the - schema for improved perfomance. Unfortunately at the time of + schema for improved perfomance. Unfortunately, at the time of this writing not all RELAX NG validators support XML catalogs. All of the examples are given in both RNG and RNC form. Empty customization file