Re: [docbook] Description/signal/properties links in html pages (generated using xsltproc) not working

[Thomas Schraitle <tom_schr@web.de>]

Hi Vishnu,

On Montag, 4. Mai 2020 15:09:35 CEST Vishnu Motghare wrote:
> I'm trying to generate documentation for gdbus interfaces.
> I've used gdbus-codegen command  to generate docbook,xml files.
> [...]
> Above command generated docbook-net.Corp.MyApp.Frobber.xml which Is
> included in my-doc.xml file.
> 
> Example my-doc.xml
> {{{
> <?xml version="1.0"?>
> <!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V5.0//EN'
>                      
> 'http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd' [ <!ENTITY %
> local.common.attrib "xmlns:xi  CDATA  #FIXED
> 'http://www.w3.org/2003/XInclude'">
> ]>

The XInclude namespace is wrong. Change "2003" to "2001". See here:

  https://www.w3.org/TR/xinclude/#syntax

If I remember correctly, there was an failed attempt to change the namespace. 
However, they switched back to the "old" one.

Apart from that, even if you add the correct namespace, it won't work. There 
are no XInclude elements in the DocBook 5.0 DTD. Better use the solution 
below.

Just to let you know, upcoming releases of DocBook does _not_ contain the DTD 
anymore. You should consider switching to RELAX NG and validating your DocBook 
documents with jing.


> [...]
>     <xi:include href="docbook-net.Corp.MyApp.Frobber.xml"/>
> [...]
> Html pages generated, but description, signal,properties links at top
> left are not working properly.

The referenced resource could not be included due to the wrong namespace. 
Better add the XInclude namespace directly like so:

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
              href="docbook-net.Corp.MyApp.Frobber.xml"/>

Can you add it and see if that works? If that doesn't help, watch for any 
error messages.


-- 
GruÃ/Regards
  Thomas Schraitle