From owner-freebsd-doc Sat Aug 26 07:50:01 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id HAA19943 for doc-outgoing; Sat, 26 Aug 1995 07:50:01 -0700 Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id HAA19931 for ; Sat, 26 Aug 1995 07:49:59 -0700 Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id JAA03995; Sat, 26 Aug 1995 09:49:48 -0500 From: John Fieber Message-Id: <199508261449.JAA03995@fieber-john.campusview.indiana.edu> Subject: Re: "too many notes" To: jkh@time.cdrom.com (Jordan K. Hubbard) Date: Sat, 26 Aug 1995 09:49:48 -0500 (EST) Cc: doc@freebsd.org In-Reply-To: <117.809446519@time.cdrom.com> from "Jordan K. Hubbard" at Aug 26, 95 07:15:19 am X-Mailer: ELM [version 2.4 PL24] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 2644 Sender: doc-owner@freebsd.org Precedence: bulk Jordan K. Hubbard writes: > > > Finally, things can be helped somewhat by providing better > > navigation controls which I will work on (after I figure out some > > cryptic variable names I neglected to document :). Namely, and a > > line at the top showing where you are: > > > > FreeBSD Handbook > > Installing FreeBSD : Supported Configurations : Ethernet Cards > > Previous: Disk Controllers > > Next: Miscellaneous > > And the Up, right? Let's not forget the Up. :-) Ah. You missed it. Maybe it will need to be more explicit. In a WWW browser, everything in this header is a link except "Ethernet Cards" which is the current page. "Supported Configurations" is one link *up*, "Installing FreeBSD" is two links up, "FreeBSD Handbook" is three links up. > two copies at once and in multiple languages, at that! That reminds > me, we have no top level switch on the pages for selecting the > language you want them in, but I suppose we can get to that later when > we figure out just what the heck we're going to do with the whole > multi-lingual thing. It's not exactly a _small_ issue, mind you, and SGML marked sections can be used for such purposes. Marked sections behave essentially like an #ifdef FOO ... #endif. They could be used for multi-lingual purposes. They could also be used to generate subsets of the handbook, such as the install documents that go on the boot floppy. I'll have to scratch my head a couple minutes to figure out the best way to do this. > we've probably put it off a little longer that we should have even > now. Far better would be to scoop all the sysinstall/help//... > files straight into the handbook with the appropriate edits. > versions of the desired manuals on the install floppies. Sure and as > I'd like to stick the HTML versions on there too, of course, but I > don't think that I'm going to manage to get Lynx on the boot floppy! > Maybe on the root floppy, maybe.. Hmmmmmmm! :-) > That'd still leave at least a few "intro" docs in ASCII though, just > to tide the user through enough screens to *get* the root floppy > loaded. It makes little sense to have both ASCII and HTML on the install disk since you can probably write a function to program to do minimal HTML formatting in less space. Since the HTML from the handbook is machine generated, error handling need not be as robust as for a general purpose browser. Heck, you could probably even get it to follow simple links to other html files. -john == jfieber@cs.smith.edu ========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============