This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: [docbook-apps] Modularization technique
I don't mind a bit.
Using the system entities directly instead of through
XInclude will certainly work to assemble the content,
and it is something that FrameMaker will understand.
But it also means each system entity file cannot have a
DOCTYPE declaration, so each module cannot be treated by
all tools as a valid mini document. As Jeff pointed out,
it is possible to work around this problem with some tools
that have their way of identifying and loading a DTD without
using a DOCTYPE declaration. Usually it means hiding
a DTD reference in a comment. But there is no standard
way of doing that.
By using XInclude, each file module can have its
DOCTYPE declaration, so it can be edited and
validated by any XML tool.
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
On Mon, Aug 11, 2003 at 07:46:08PM -0500, Bob Foster wrote:
> (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
>
>
--
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
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org