Re: Help needed to use ENTITY in docbook5 (convert from docbook4)

"openhab.doc" <[email protected]> Mon, 28 May 2018 22:29:16 +0200
Newsgroups gmane.text.docbook.misc
Message-ID <1592803.IjMIz920Gv@pierre-pc>
Hi,
I don't quite understand the execution. In had once read (for docbook4) that the files 
included with xi:include should be built so that they are executable themselves. Is this 
correct?
Based on the correspondence I have now implemented it as follows:

*The main file looks like this (extract):*

    <?xml version="1.0" encoding="utf-8"?>

    <!DOCTYPE book [
		<!ENTITY % darktable_ent SYSTEM "../darktable.ent">
		%darktable_ent;
    ]>

   <book
       version="5.0"
       xmlns="http://docbook.org/ns/docbook" 
       xmlns:xi="http://www.w3.org/2001/XInclude" 
       xmlns:xlink="http://www.w3.org/1999/xlink" 
       xml:lang="en"
       status="final"
       xml:id="darkroom_chapter">
     
    <!--- an so on -->

     <xi:include href="overview/overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/
>

*The included file looks like:*

    <?xml version="1.0" encoding="utf-8"?>

    <!DOCTYPE chapter [
		<!ENTITY % darktable_ent SYSTEM "../darktable.ent">
		%darktable_ent;
    ]>

    <chapter 
        version="5.0"
        xmlns="http://docbook.org/ns/docbook" 
        xmlns:xi="http://www.w3.org/2001/XInclude" 
        xmlns:xlink="http://www.w3.org/1999/xlink" 
        xml:lang="en"
        status="final"
        xml:id="overview_chapter">

    <!--- an so on -->

*Is this the correct way or do I have to change something?*

Thanks in advance
Pierre

Am Montag, 28. Mai 2018, 12:08:44 CEST schrieb Jirka Kosek:
> On 25.5.2018 9:23, victory wrote:
> > I think this is caused by this change:
> > https://github.com/docbook/docbook.org/issues/17
> 
> Please note that there were not made change. The problem is that with
> DocBook 4 people usually used external entities to break document into
> several smaller files. If this approach is used entities defined in the
> main file are inherited to files included via entity mechanism.
> 
> For DocBook 5 XInclude is usually used for modularity. With XInclude
> situation is different. Each xincluded file is parsed separately and
> does not inherit entity declarations from the main file. So with
> XInclude entity declarations has to be repeated at the beginning of each
> file.
> 
> But in fact this is not directly related to differences between DocBook
> 4 and 5. You can use XInclude with DocBook 4 or external entities with
> DocBook 5.
> 
> But using entities for accented characters in 2018 seems really wrong.
> Appropriate Unicode characters should be used directly in the files.
> 
> 				Jirka