Re: [docbook-apps] Modularization technique

["Bob Foster" <bob at objfac dot com>]

(I hope Bob doesn't mind being copied on all this mail.)

From: "Taro Ikai" <tikai@ABINITIO.COM>
> Bob talks about the use of <xi:include> and <olink> as a solution for this
> problem at his web site:
>
>     http://www.sagehill.net/docbookxsl/ModularDoc.html

I don't get it. Bob has this example:
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
                    "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd";
[
<!ENTITY intro              "part1/intro.xml">
<!ENTITY basics             "part1/getting_started.xml">
<!ENTITY config             "admin/configuring_the_server.xml">
<!ENTITY advanced           "admin/advanced_user_moves.xml">
]>
<book>
<title>User Guide</title>
<para>This guide shows you how to use the software.</para>
<xi:include  href="&intro;"    xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include  href="&basics;"   xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include  href="&config;"   xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include  href="&advanced;" xmlns:xi="http://www.w3.org/2001/XInclude"/>
...
</book>
Why not just...

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
                    "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd";
[
<!ENTITY intro              SYSTEM "part1/intro.xml">
<!ENTITY basics             SYSTEM "part1/getting_started.xml">
<!ENTITY config             SYSTEM "admin/configuring_the_server.xml">
<!ENTITY advanced           SYSTEM "admin/advanced_user_moves.xml">
]>
<book>
<title>User Guide</title>
<para>This guide shows you how to use the software.</para>
&intro;
&basics;
&config;
&advanced;
...
</book>
Bob Foster


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org