OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

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

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:


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 

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";

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

  Thomas Schraitle

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]