[dbdoclet] Re: Part/reference relationship

Hello Michael,

sorry, I misinterpreted the TDG wording. You are right, of course -- a
part can contain a reference.

The error was actually caused by the same package.html handling issue I
reported earlier, i.e. dbdoclet pulled in the contents of a package.html
file verbatim, not converting the HTML to DocBook XML. This caused a
validation error. Somehow I came to the conclusion I posted, but that
was false. Sorry again.

Any ideas on a workaround for the moment? I was thinking of converting
the package.html files with html2db, but I can't think of a way to pull
the resulting DocBook XML in at the right place.

--Jere

>-----Original Message-----
>From: dbdoclet-bounce@xxxxxxxxxxxxx 
>[mailto:dbdoclet-bounce@xxxxxxxxxxxxx] On Behalf Of ext Michael Fuchs
>Sent: 15 August, 2005 15:10
>To: dbdoclet@xxxxxxxxxxxxx
>Subject: [dbdoclet] Re: Part/reference relationship
>
>Hello Jere,
>
>when I look at http://www.docbook.org/tdg/en/html/part.html, I 
>find the following section:
>
>Children
>
>The following elements occur in part: appendix, article, 
>beginpage, bibliography, chapter, glossary, index, lot, 
>partinfo, partintro, preface, refentry, reference, subtitle, 
>title, titleabbrev, toc.
>
>The reference tag seems to be a valid child of a part tag. Can 
>you send me the error message of the parser?
>
>Regards
>Michael
>
>Jere.Kapyaho@xxxxxxxxx wrote:
>>Hello,
>>
>>when using dbdoclet 0.64.2 with the following settings:
>>
>>docbook.part=true
>>doclet.noprolog=true
>>doclet.book.type=reference
>>doclet.style.type=strict
>>
>>the resulting docs/Reference.xml contains the following structure:
>>
>><part lang="en">
>>  <title>API Reference</title>
>><reference id="PACKAGE-1" xreflabel="com.acme.something">
>>  <title>com.acme.something</title>
>>.
>>.
>>.
>></reference>
>></part>
>>
>>However, seems that this is not allowed by the DocBook DTD:
>>
>>"In a Book, a Reference can occur at either the Part or 
>Chapter level."
>>(DoBook TDG v2.0.12)
>>
>>How to get rid of the surrounding 'part' element when using the 
>>reference style? (without resorting to manual editing)
>>
>>--Jere
>>
>>  
>
>
>--
>-------------------------------------
>Dipl.-Ing. (FH) Michael Fuchs
>Phone: 0 81 61/ 14 41 66
>Fax: 0 81 61/ 14 05 21
>E-Mail: michael.fuchs@xxxxxxxxxxxxxxx
>Homepage: http://www.dbdoclet.org
>
>
>

Other related posts: