From owner-freebsd-doc Tue May 30 11:18:32 2000 Delivered-To: freebsd-doc@freebsd.org Received: from typhoon.mail.pipex.net (typhoon.mail.pipex.net [158.43.128.27]) by hub.freebsd.org (Postfix) with SMTP id 5E13D37B5FB for ; Tue, 30 May 2000 11:18:27 -0700 (PDT) (envelope-from mark@dogma.freebsd-uk.eu.org) Received: (qmail 17397 invoked from network); 30 May 2000 18:18:24 -0000 Received: from useraw35.uk.uudial.com (HELO parish.my.domain) (62.188.138.181) by smtp.dial.pipex.com with SMTP; 30 May 2000 18:18:24 -0000 Received: (from mark@localhost) by parish.my.domain (8.9.3/8.9.3) id TAA00969; Tue, 30 May 2000 19:16:16 +0100 (BST) (envelope-from mark) Date: Sat, 27 May 2000 17:33:55 +0100 From: Mark Ovens To: Nik Clayton Cc: doc@freebsd.org Subject: Re: Why no Master Index? Message-ID: <20000527173355.B599@parish> References: <20000523194307.C233@parish> <20000524084850.A8565@kilt.nothing-going-on.org> <20000525191547.B232@parish> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i X-Mailer: Mutt 1.0.1i X-Mailer: Mutt 1.0.1i In-Reply-To: <20000525191547.B232@parish>; from mark@ukug.uk.freebsd.org on Thu, May 25, 2000 at 07:15:47PM +0100 Organization: Total lack of Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, May 25, 2000 at 07:15:47PM +0100, Mark Ovens wrote: > On Wed, May 24, 2000 at 08:48:50AM +0000, Nik Clayton wrote: > > On Tue, May 23, 2000 at 07:43:07PM +0100, Mark Ovens wrote: > > > Is there a reason why there is no Master Index/TOC for the FreeBSD > > > docs? > > [snip] > > Your example looked good. Do you want to turn that in to HTML (based on > > the existing contents of www/en), and we can go from there. > > > > OK, ftp://ukug.uk.freebsd.org/pub/mark/doc_index/ for my first > attempt. I've put both the HTML and the SGML I made it from > (sgmlnorm -d example.sgml > example.html). The links assume it is in > /usr/share/doc. > Nik, I've done some more work on this. The files are ftp://ukug.uk.freebsd.org/pub/mark/doc_index/*.{html,sgml}. If you put them in /usr/share/doc then all the links (should) work. I'd appreciate some feedback before I proceed much further, in case I'm heading down the wrong route. > > You might want to take a look at http://www.freebsd.org/docs.html, and > > try trimming that down. One way to do it would be to split things in two > > based on whether or not they're maintained by the project. > > > > So have a docs/index.html that offers the reader links to the two files, > > and an 'internal.html' that lists the project maintained docs, and an > > 'external.html' that lists the other stuff ('internal' and 'external' are > > crap names, please, come up with better ones :-) ) > > OK, I've used "native" and "related" in the samples. How do those sound? > > I also wouldn't mind seeing a translation table that listed all the docs, > > and an indication of whether or not they've been translated. . . > > > > en es fr ja ru zh > > Handbook x x x > > FAQ x x x x x x > > FDP Primer x > > Porter's Handbook x x > > [...] > > > Done. [snip] -- ...and on the eighth day God created UNIX ________________________________________________________________ FreeBSD - The Power To Serve http://www.freebsd.org My Webpage http://ukug.uk.freebsd.org/~mark/ mailto:mark@ukug.uk.freebsd.org http://www.radan.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message