From owner-freebsd-doc Sat May 27 14:42:56 2000 Delivered-To: freebsd-doc@freebsd.org Received: from praseodumium.btinternet.com (praseodumium.btinternet.com [194.73.73.82]) by hub.freebsd.org (Postfix) with ESMTP id B851A37B784; Sat, 27 May 2000 14:42:48 -0700 (PDT) (envelope-from mark@ukug.uk.freebsd.org) Received: from [62.7.76.243] (helo=parish.my.domain) by rhenium with esmtp (Exim 3.03 #16) id 12vjdp-0004qz-00; Sat, 27 May 2000 17:40:49 +0100 Received: (from mark@localhost) by parish.my.domain (8.9.3/8.9.3) id RAA01034; Sat, 27 May 2000 17:40:41 +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 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