[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: 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
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]