Re: [docbook] Help needed with xi.include in docbook5 (convert from docbook4)

["openhab.doc" <openhab.doc@web.de>]

Hi Thomas,

thanks for your explanation and the link to your cookbook.

Pierre

Am Donnerstag, 24. Mai 2018, 08:53:58 CEST schrieb Thomas Schraitle:
> Hi Pierre,
> 
> Am Thu, 24 May 2018 08:27:02 +0200
> 
> schrieb openHAB.Doc@web.de:
> > How do I use xi:include in docbook5?
> 
> Read the topic "Modularize Your Document with XIncludes" in my cookbook:
> 
>   http://doccookbook.sf.net/html/en/dbc.markup.xincludes.html
> 
> ;-)
> 
> > In the main document I have following entry:
> > 
> > <xi:include href="overview/overview.xml"
> > xmlns:xi="http://www.w3.org/2001/XInclude"/>
> > 
> > The overview.xml is currently defined as docbook4 (see extract from
> > overview.xls below). May this the problem?
> 
> Don't mix both versions. It may work, but it can give you all sorts of
> strange problems and make things more complicated. Better stay with
> version 4 _or_ version 5.
> 
> > When I try to create the html file
> > 
> > xsltproc --output
> > darktable.html /home/pierre/Downloads/docbook-xsl-1.79.2/xhtml/docbook.xsl
> > darktable.xml
> > 
> > I get following message:
> > 
> > Element include in namespace 'http://www.w3.org/2001/XInclude'
> > encountered in book, but no template matches.
> > 
> > What does the message mean?
> 
> Well, it means you haven't resolved the XInclude with the respective
> file. :)
> 
> The xi:include element is a "pointer" to a file that has to be
> included. If you don't resolve the file, the xi:include element stays
> as it is and it is seen by the DocBook stylesheet. However, the
> stylesheets doesn't define any template processing for this element.
> 
> To resolve the "xi:include" element you need to add the --xinclude
> option for your xsltproc processor.
> 
> > [...]