Date: Mon, 3 Jul 1995 14:27:07 -0400 (EDT) From: jfieber@grendel.csc.smith.edu (John Fieber) To: gclarkii@freefall.cdrom.com (Gary Clark II) Cc: doc@freebsd.org Subject: Re: What's the story with the FAQ? Message-ID: <199507031827.OAA09148@grendel.csc.smith.edu> In-Reply-To: <199507011125.EAA16261@freefall.cdrom.com> from "Gary Clark II" at Jul 1, 95 04:25:54 am
next in thread | previous in thread | raw e-mail | index | archive | help
[CCd to doc@freebsd.org because this brings up document architecture issues of general interest.] Gary Clark II writes: > I need "TEXT" versions of the stuff in the handbook before I can > point ftp users at them. Thats what I thought /FAQ/Text was! If we have a hypertext FAQ, and a hypertext handbook that is to be referenced from the FAQ, pointing at a plain text version is a pretty big step backward. In the FAQ use a relative url of "../handbook/whatever.html". As for "whatever", grep the sgml files in the handbook directory for '<label id'. Every .sgml file in the handbook directory (except authors.sgml and handbook.sgml) has a label matching the filename sans .sgml. For example, ctm.sgml has a <label id="ctm"> and could be referenced from the faq with a url of "../handbook/ctm.html". My latest commit to sgmlfmt(1) provides for making symbolic links for every <label id="..."> that point to the appropriate page since section numbers or html file numbers are moving targets. This method of linking between documents does leave some elegance to be desired, particularly because it breaks if either the FAQ or the handbook are not in the same position relative to each other. Using an absolute link to www.freebsd.org would break for people who have the HTML files local and no net.conection. It would be nifty if the HTML standard supported the specification of primary and alternate URL's in the anchor tag.... -john === jfieber@cs.smith.edu ========== Come up and be a kite! --K. Bush ===
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199507031827.OAA09148>