Re: [docbook] DocBook RNG Schema vs DocBook DTD

[Thomas Schraitle <tom_schr@web.de>]

Hi Giuseppe,

> After a few years I'm back to DocBook... and as the first step I should
> port all my stuff to DocBook "Relax NG" edition.
> 
> In the past I customized the DocBook DTD V4.1 by defining some common
> entities (e.g. corp. name, corp. website, etc.) in order to generate
> consistent documentation. In the customized DTD I added the following
> entities:
> 
> <!ENTITY corp.shortname "Agamura">
>  ...

You can also use entities in DocBook 5 like this:

------------------------
<?xml version="1.0"?>
<!DOCTYPE article
[
  <!ENTITY corp.shortname "Agamura">
  <!-- Include your definitions here -->
]>
<article xmlns="http://docbook.org/ns/docbook"; 
      xml:lang="&language;"
      xml:id="CSharpCodingGuidelines" >
  <!-- -->
</article>
------------------------

> Then, in my documents I used them as follows:
> 
> <!DOCTYPE article PUBLIC "-//AGAMURA//DTD DocBook V4.1 Extension//EN"
>     "http://www.agamura.com/quxo/dtd/1.0/docbookx.dtd"; [
>     <!ENTITY introduction SYSTEM "Introduction.xml">
>     ...
> ]>
> <article id="CSharpCodingGuidelines" lang="&language;">
> [...]
>     </articleinfo>
> 
>     &introduction;
>     ...
> </article>
> 
> In the XML above, entity &legalnotice; contains the following:

Use XInclude in this case: <xi:include href="legalnotice.xml"/>


> [...]
> ... now the question is: how can I achieve the same with the Relax NG schema?

See the Transition Guide for further information:

  http://www.docbook.org/docs/howto/

Most questions are answered there. :-)

Hope that helps,
Tom