From: Jirka Kosek Date: Tue, 28 Feb 2006 21:44:12 +0000 (+0000) Subject: More copy edit changes from Dick, new release X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=7f60aad27498957cdf46eb2b8ed1225454c624c2;p=docbook-dsssl More copy edit changes from Dick, new release --- diff --git a/docbook/relaxng/docbook/howto/howto.xml b/docbook/relaxng/docbook/howto/howto.xml index a70c5bfc7..da23aa76d 100644 --- a/docbook/relaxng/docbook/howto/howto.xml +++ b/docbook/relaxng/docbook/howto/howto.xml @@ -20,6 +20,7 @@ §changes-removed, proofreading +2006-03-01 2005-12-28 2005-10-27 @@ -44,7 +45,7 @@ series. some aspects, but the basic idea behind DocBook is still the same and almost all element names are unchanged. Because of this it is very easy to become familiar with DocBook V5.0 if you know any previous version of -DocBook. You can find complete list of changes in +DocBook. You can find a complete list of changes in DB5SPEC, here we will discuss only the most fundamental changes. @@ -133,20 +134,18 @@ attribute instead. As you can see, DocBook V5.0 is built on top of existing XML -standards as much as possible and the lang -attribute is superseded by the standard xml:lang attribute. +standards as much as possible, for example the +lang attribute is superseded by the +standard xml:lang attribute. -Another fundamental change here is that there is no direct indication +Another fundamental change is that there is no direct indication of the schema used. Later in this document, you will learn how you can specify a schema to be used for document validation. -Although using the RELAX NG schema with DocBook -V5.0 is recommended, -there are also DTD and W3C XML Schema versions available (see ) to satisfy tools that do not yet support -RELAX NG. +Although we recommend the RELAX NG schema for DocBook +V5.0, there are also DTD and W3C XML Schema versions available (see ) for tools that do not yet support RELAX NG. @@ -161,7 +160,7 @@ technical reasons: DocBook V4.x is feature frozen. At the time -of this writing DocBook V4.5 is the last version of DocBook in V4.x +of this writing DocBook V4.5 is the last version of DocBook in the V4.x series. Any new DocBook development, like the addition of new elements, will be done in DocBook V5.0. It is only matter of time before useful, new elements will be added into DocBook V5.0, but they are not likely to be @@ -173,7 +172,8 @@ and errata will be published if necessary. DocBook V5.0 offers new functionality. Even the current version of DocBook V5.0 provides significant improvements over DocBook V4.x. For example there is general markup for annotations, -a new and flexible system for linking, … +a new and flexible system for linking, and unified markup for information +sections using the info element. DocBook V5.0 is more extensible. Having @@ -286,7 +286,7 @@ schema. Emacs and nXML nXML -mode is an addon for the is an add-on for the GNU Emacs text editor. By installing nXML you can turn Emacs into a very powerful XML editor that offers guided editing and @@ -317,13 +317,13 @@ schema: Please note that nXML ships with a file named docbook.rnc. This file contains the RELAX NG grammar -for DocBook V4.x. Be sure that you associate DocBook V5.0 namespace +for DocBook V4.x. Be sure that you associate the DocBook V5.0 namespace with the corresponding DocBook V5.0 grammar. -If you can't edit global schemas.xml file, +If you can't edit the global schemas.xml file, you can create this file in a directory with your document. nXML will -find associations placed here also. In this case you must create +find associations placed there also. In this case you must create a complete configuration file like: <locatingRules xmlns="http://thaiopensource.com/ns/locating-rules/1.0"> @@ -435,10 +435,10 @@ 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. -You can find list of RELAX NG validators at You can find a list of RELAX NG validators at . It is best to use validators with support for embedded Schematron rules inside RELAX NG -schema. Schematron is a rule-based validation language which is used +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. @@ -449,13 +449,13 @@ To install and use MSV follow these steps: -Download file relames.zip from . +Download relames.zip from . -Unpack the downloaded file into arbitrary directory. +Unpack the downloaded file into an arbitrary directory. -Validate your document by using the following command: +Validate your document using the following command: java -Xss512K -jar /path/to/relames.jar /path/to/docbook.rng document.xml The switch increases the stack size @@ -563,7 +563,7 @@ the stylesheets are developed in the limited free time the developers have, there's no specific schedule. There are not very many XSLT 2.0 implementations available. -But, if you want to try the new stylesheets, grab snapshot of +But, if you want to try the new stylesheets, grab a snapshot of the development version from and unpack it somewhere. Then download and install Saxon 8 from . Markup changes This section describes the most common markup changes -between DocBook V4.x and V5.0 in several examples. +between DocBook V4.x and V5.0. You can find a complete list of changes in DB5SPEC. @@ -650,7 +650,7 @@ element: DocBook site]]> -XLink links can contain a fragment identifier, which you can +XLink links may contain a fragment identifier, which you can use instead of linkend to form cross-references inside a document; for example: @@ -1053,17 +1053,17 @@ one usable XSLT 2.0 processor available. -How can I extend DocBook schema with MathML elements? +How can I extend the DocBook schema with MathML elements? -The basic DocBook schema allows any elements from the MathML namespace +The basic DocBook schema allows elements from the MathML namespace to appear inside the equation element. This means that you can validate a DocBook+MathML document, but MathML content will be ignored during the validation. You will also not be able to use guided editing for the MathML content. If you need strict validation of MathML content or guided editing for MathML, you can easily extend the base DocBook schema with -a MathML schema. +the MathML schema. Extending the DocBook schema with the MathML schema