Date: Mon, 6 Dec 2004 13:23:57 -0800 From: Murray Stokely <murray@freebsdmall.com> To: Nik Clayton <nik@freebsd.org> Cc: doc@freebsd.org Subject: Re: Time for a Network Handbook? Message-ID: <20041206212357.GE84191@freebsdmall.com> In-Reply-To: <20041206192017.GE72462@clan.nothing-going-on.org> References: <20041205114254.GD23252@clan.nothing-going-on.org> <41B3617B.3080507@centtech.com> <20041206192017.GE72462@clan.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, Dec 06, 2004 at 07:20:18PM +0000, Nik Clayton wrote: > Partly to move closer (as others have said) to having a collection of > Handbooks. But mainly because I was glancing over the existing content Yes, we got consensus this summer to move out the system admin part into an administrator handbook, and I'd still support someone doing that at the same time as the network <part> is moved out. It would be great if this was done in a transparent way... One thing we should think about is using link entities to allow the different chapters to be included in different books without breaking the build due to broken references. Currently, the single-chapter builds often fail because xrefs to other chapters can not be looked up. If we replaced all xrefs to other chapters with entities like: &link.chapter.sect; Then we could define that entity depending on the presence of the -i parameter entity for the given chapter file. If the chapter to be linked to is included in the build (and it's -i entity defined), then the <xref> is created. If it is not included in the build, then descriptive text is used instead 'The Blah Chapter in the Handbook'. In this way, we could more easily move chapters around between books without having to update all of the cross-chapter references. This would also allow us to easily maintain a full version of the Handbook that includes all of the chapters, in addition to the split off 'network handbook', 'admin handbook', etc. It's a stop-gap until we get proper olink support, basically. I explored a little of this work for the printed third edition, when we split it into two volumes, and it worked well for that purpose. We created a new links.ent file with the necessary parameters defined as I specified above. - Murray
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20041206212357.GE84191>