This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: Document structure; how to setup...
- From: Bob Stayton <bobs at caldera dot com>
- To: Kraa de Simon <Simon dot de dot Kraa at services dot fujitsu dot com>,"'docbook-apps at lists dot oasis-open dot org'" <docbook-apps at lists dot oasis-open dot org>
- Date: Fri, 01 Nov 2002 09:17:40 -0800
- Subject: Re: DOCBOOK-APPS: Document structure; how to setup...
- References: <C1EBEEBBB842D411B4120000949A1F580201A67F@wwmessd135>
Another approach is to use XInclude instead of
system entities. I wrote a chapter about using
XIncludes and olinks for modular documents:
http://www.sagehill.net/xml/docbookxsl/ModularDoc.html
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
Caldera International, Inc. fax: (831) 429-1887
email: bobs@caldera.com
On Thu, Oct 31, 2002 at 09:38:12PM +0100, Kraa de Simon wrote:
> Hello,
>
> I have a few question for you. If you would be so kind...
>
> Q1
>
> Is there a way to do something like:
>
> <!-- set.xml -->
> <!DOCTYPE set SYSTEM "docbookx.dtd">
> <set>
> <!-- book1.xml -->
> <!DOCTYPE book SYSTEM "docbookx.dtd">
> <book>
> </book>
>
> <!-- book2.xml -->
> <!DOCTYPE book SYSTEM "docbookx.dtd">
> <book>
> </book>
> </set>
>
> or
>
> - DOCTYPE set
> - set
> - book1
> - book2
>
> and
>
> - DOCTYPE book1
> - book1
>
> - DOCTYPE book2
> - book2
>
> So the editors can process the set and individual books (chapters?)
> separately.
>
> Q2
>
> Can I xref from one book to another?
>
> E.g. from book1.xml to book2.xml.
>
> Q3
>
> Can someone give me some hints and tips about how to setup the directory
> structure on disk?
>
> Can I use some nested entity definitions for this?
>
> Use logical names (e.g. users_manual.xml, users_manual_chapter_one.xml) or
> book01.xml, chapter01.xml.
>
> Is there some reading material / papers available on this subject?
>
> ./set.xml
> ./book1.xml
> ./book1ch1.xml
> ./book1ch2.xml
> ./book2.xml
> ./book2ch1.xml
> ./book2ch2.xml
>
> or
>
> ./set.xml
> ./book/1/book.xml
> ./book/1/ch/1.xml
> ./book/1/ch/2.xml
> ./book/2/book.xml
> ./book/2/ch/1.xml
> ./book/2/ch/2.xml
>
> And where to put the images, entities and other stuff?
>
> Separate dirs? Per set or per book?
>
> I really could use some hints and tips from you.
>
> Thank you.
>
> Simon de Kraa
> Systems Architect
> Logistic Systems
>
> FUJITSU SERVICES
> Fujitsu Services B.V., Het Kwadrant 1
> Postbus 1726, 3600 BS Maarssen, The Netherlands
> Tel: +31 346 598865
> Mob: +31 651 204719
> Fax: +31 346 562703
>
> Email: mailto:Simon.de.Kraa@services.fujitsu.com
> Web: http://nl.services.fujitsu.com
>
> Fujitsu Services B.V., Registered in the Netherlands no 30078286
> ___________________________________________________________________________
>
> The information in this e-mail (and its attachments) is confidential and
> intended solely for the
> addressee(s). If this message is not addressed to you, please be aware that
> you have no
> authorisation to read this e-mail, to copy it or to forward it to any person
> other than the
> addressee(s). Should you have received this e-mail by mistake, please bring
> this to the
> attention of the sender, after which you are kindly requested to destroy the
> original message
> and delete any copies held in your system. Fujitsu Services and its
> affiliated companies
> cannot be held responsible or liable in any way whatsoever for and/or in
> connection with
> any consequences and/or damage resulting from the contents of this e-mail
> and its proper
> and complete dispatch and receipt. Fujitsu Services does not guarantee that
> this e-mail has
> not been intercepted and amended, nor that it is virus-free.
> ___________________________________________________________________________
>
--