On 03/01/2017 10:33 AM, nobili, philippe wrote:

For the record, it seems that the assembly processor (version 1_0_0) may generate 
invalid DocBook-5 documents in presence of <relationships> between topic.

Indeed, the <relationships>[...]</relationships> element is realized into an itemized 
list which is placed at the end of the topic, that is possibly after a <section> element 
for instance (we have a topic with two  sections).

That's right. We have chosen the simplest, most straightforward, strategy.



It does not prevent the realized DocBook document from being converted thought.

This is NOT a bug. This is explicitly allowed by the DocBook assembly specification.

Excerpts of http://tdg.docbook.org/tdg/5.1/ch06.html#structures
---
It is important to observe that the realized structure is often, but not necessarily, a valid DocBook document. What is important is not it's validity from an authoring perspective, but rather it's validity with respect to what the downstream processor is expecting.
---

The realized document does not have to be a valid, self-contained, DocBook 5.1 document. Suffice for it to be convertible to other formats by the DocBook XSL stylesheets.

In other words, the realized document must not be considered to be a source DocBook 5.1 document but just a temporary, intermediate file.

The DocBook XSL stylesheets have no problems whatsoever with our translation of <relationships> in the realized document. Therefore we consider that what we do is OK.





--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Reply via email to