Hi Otto,
You have certainly pointed out an inconsistency. I'm researching this
and will get back to you.
Bob Stayton
Sagehill Enterprises
[email protected]
On 9/21/2017 11:42 AM, Otto Hirr wrote:
Greetings,
I am beginning to use DocBook Assemblies. I may have a
misunderstanding of "contentonly" attribute of "module" element.
The //contentonly="true"// seems to pull in the meta info of the
subsuming "topic" element.
I was under impression from another source that the "contentonly"
would pull in the content of the subsuming element without the
meta-information of the subsuming element.
By way of running the sample topics and assemble shown below, it seems
the implementation of //contentonly="true"//, is simply to discard the
root element, "topic". This would be a strict elimination of the
subsuming element, "topic."
However this simplistic kind of implementation would then leave the
info which is a meta-detail of the now-discarded "topic" element.
This results in an invalid docbook file.
(Below I give two topics, an assemble, the output generated, and the
output I would have expected.)
(My understanding is that OxygenXMLv19 is providing 1.79.2, which is
the environment in which I ran this sample file set.)
It would seem that the logical complete implementation would be to
discard the topic-root-element and any accompanying meta details of
the info-element which is associated with the topic-root-element.
Please correct any misunderstanding I have, still very much a beginner
of DocBook.
Also, should there be an xml:base generated for each item that is
transcluded (if that is the correct term)?
Best regards,
..Otto
====Topic1====file:prob1-topic1.xml====>
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://docbook.org/xml/5.1/rng/docbook.rng";
schematypens="http://relaxng.org/ns/structure/1.0";?>
<?xml-model href="http://docbook.org/xml/5.1/sch/docbook.sch";
type="application/xml"
schematypens="http://purl.oclc.org/dsdl/schematron";?>
<topic xml:id="t1" xmlns="http://docbook.org/ns/docbook";
xmlns:xlink="http://www.w3.org/1999/xlink"; version="5.1" >
<info> <title>prob1-topic1</title> </info>
<para>Paragraph contained in topic #1.</para>
</topic>
<====Topic1====
====Topic2====file:prob1-topic2.xml====>
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://docbook.org/xml/5.1/rng/docbook.rng";
schematypens="http://relaxng.org/ns/structure/1.0";?>
<?xml-model href="http://docbook.org/xml/5.1/sch/docbook.sch";
type="application/xml"
schematypens="http://purl.oclc.org/dsdl/schematron";?>
<topic xml:id="t2" xmlns="http://docbook.org/ns/docbook";
xmlns:xlink="http://www.w3.org/1999/xlink"; version="5.1" >
<info> <title>prob1-topic2</title> </info>
<para>Paragraph contained in topic #2.</para>
</topic>
<====Topic2====
====Assembly====file:prob1-assy1.xml>
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://docbook.org/xml/5.1/rng/assembly.rng";
schematypens="http://relaxng.org/ns/structure/1.0";?>
<?xml-model href="http://docbook.org/xml/5.1/sch/assembly.sch";
type="application/xml"
schematypens="http://purl.oclc.org/dsdl/schematron";?>
<assembly version="5.1" xmlns="http://docbook.org/ns/docbook";>
<resources>
<resource href="prob1-topic1.xml" xml:id="topic1"/>
<resource href="prob1-topic2.xml" xml:id="topic2"/>
</resources>
<structure renderas="book">
<merge><title>Book title of sample assembly of topics</title></merge>
<module renderas="chapter" xml:id="chapter1">
<merge><title>Title of first chapter</title></merge>
<module contentonly="true" resourceref="topic1"/>
<module contentonly="true" resourceref="topic2"/>
</module>
</structure>
</assembly>
<====Assembly====
====Result====>
<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook"; version="5.1">
<info>
<title>Book title of sample assembly of topics</title>
</info>
<chapter xml:id="chapter1">
<info>
<title>Title of first chapter</title>
</info>
<info xmlns:xlink="http://www.w3.org/1999/xlink";>
<title>prob1-topic1</title>
</info>
<para xmlns:xlink="http://www.w3.org/1999/xlink";>Paragraph
contained in topic #1.</para>
<info xmlns:xlink="http://www.w3.org/1999/xlink";>
<title>prob1-topic2</title>
</info>
<para xmlns:xlink="http://www.w3.org/1999/xlink";>Paragraph
contained in topic #2.</para>
</chapter>
</book>
<====Result====
====Result of what I thought should be generated====>
<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook"; version="5.1">
<info>
<title>Book title of sample assembly of topics</title>
</info>
<chapter xml:id="chapter1">
<info>
<title>Title of first chapter</title>
</info>
<para xmlns:xlink="http://www.w3.org/1999/xlink";>Paragraph
contained in topic #1.</para>
<para xmlns:xlink="http://www.w3.org/1999/xlink";>Paragraph
contained in topic #2.</para>
</chapter>
</book>
<====Result of what I thought should be generated====
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
