How to Xinclude an Introduction in a chapter (ie, no <section>)?

[Jeffrey Walton <noloader@gmail.com>]

Hi All,

I have a *really* long chapter. I thought I would break it down so
that the chapter had a bunch of xinclude's with the following
structure:

$ cat test.xml
<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd";>

<book>
<chapter id="ch_test">
 <title>Chapter Test</title>
 <xi:include href="test-intro.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
 <xi:include href="test-section.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
 ....
</chapter>
</book>

$ cat test-intro.xml
<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd";>
<simplesect>
 <indexterm>
   <primary>Foo</primary>
 </indexterm>

 <para>Foo is mildly discussed in this introduction.</para>
</simplesect>

The problem I am having is: (1) the introduction is *not* a section -
it starts of with <indexterm> and then <para>; and (2) it won't
validate. I also tried wrapping the introduction in <simplesect>, but
no joy. I've attached a simple test case (xmllint-test.zip).

How does on xinclude free form text which is part of <para> (but has
no corresponding <section>)?

My apologies if the attachment is not appropriate.
http://www.docbook.org/guidelines did not appear to ban simple test
cases.

Jeffrey Walton

Attachment: xmllint-test.zip
Description: Zip archive