RE: DOCBOOK-APPS: file path peculiarity with xinclude

[Lisa Carey <lisa.carey@havok.com>]

Hi Bob,

No, I'm xincluding the documents that themselves incorporate additional
material using system entities. Sorry if it wasn't clear.

They're xincluded as follows in the master document:

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
href="mydocument1.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
href="mydocument2.xml"/>

where mydocument1 and mydocument2 both use system entities.  The system
entities are all pulled in properly if I generate separate HTML docs from
mydocument1 and mydocument2. However, only the system entities that are
declared directly in mydocument1 and mydocument2 are found if I try to
resolve the xincludes in the master document.  The entities that are
declared in a separate entities file and used by both documents can't be
found.

I can work around this, I'm just puzzled!

cheers,

Lisa


-----Original Message-----
You didn't show your xinclude element,
But I think the problem is that you are trying to use a
reference to a system entity in your xinclude href
attribute value.  If it looks like this:

  href="&foo;"

it won't work.  An xinclude href needs a URI, not a system
entity reference.  A SYSTEM entity reference tries to load
the contents of the referenced file.  Think of it as trying
to load the contents of foo.xml into the attribute value.

If you define ordinary text entities instead, it will
work:

<!ENTITY foo "../../common/foo.xml">
<!ENTITY bar "../../common/bar.xml">
<!ENTITY tip "../../common/fooBarTip.xml">

If you still need system entities, you'll have to define
two sets of entity names and use different ones in
different contexts.
--

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The SCO Group                               fax:   (831) 429-1887
                                            email: bobs@sco.com