Re: Proposal for GNOME Developers' Guide

[Martin Wahlen <mva sbbs se>]

On Tue, 27 Oct 1998, John R Sheets wrote:

> But then, I don't know how hard it would be to connect two book-sets
> together.  Mark G, do you have any thoughts here?  The Set is the highest
> DocBook tag level, right?  Is it possible to directly reference or include
> things across Sets?  Would we even _need_ to link these two (GDG to
> GADG)?  If we wanted to render them both as a single ps file (ack!) or
> HTML site (eh, maybe), they would probably have to be under the same Set.
> Right?  Any other reasons, or am I totally off my whack?

Yes, it is posible to include stuff across sets. You will not be able to
reference across sets without using the mechanisms for URL linking. But i
guess that is secondary. So the answer is to make evry section or maybe
chapter a .ent file, or enable the SUBDOC feature of SGML.  
 
> As I understand it, as long as you have a path to the sgml file, you can
> reference it as an external entity.  As long as all the SGML doc files get
> installed into a sane tree, we should be okay here.  (I'm guessing...)

Well, there are two ways of doing this. You can make public identifiers
and catalog files. Or you can use the SYSTEM key word. CATALOG files may
be a bit harder to use, but with the sgmltools framework it would be
advantageous to use catalog files and public identifiers (CATALOG files
maps tings like "-//Who//whdsfh//EN" to a path.
 
Now, where is that gnome-docs list:-)

Martin (SGML novice)

===========================================================================
Martin Wahlén		Sound Foundation Inc.	    tel.    +46 (40) 454136
mwahlen@soundfound.com  Ringv. 1                    
www.soundfound.com      236 35 Höllviken
===========================================================================