From owner-freebsd-doc Wed Mar 18 01:29:35 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id BAA03903 for freebsd-doc-outgoing; Wed, 18 Mar 1998 01:29:35 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from tyree.iii.co.uk (tyree.iii.co.uk [195.89.149.230]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id BAA03865 for ; Wed, 18 Mar 1998 01:29:32 -0800 (PST) (envelope-from nik@iii.co.uk) From: nik@iii.co.uk Received: from carrig.strand.iii.co.uk (carrig.strand.iii.co.uk [192.168.7.25]) by tyree.iii.co.uk (8.8.8/8.8.8) with ESMTP id JAA00106; Wed, 18 Mar 1998 09:29:27 GMT Received: (from nik@localhost) by carrig.strand.iii.co.uk (8.8.7/8.8.7) id JAA16418; Wed, 18 Mar 1998 09:29:27 GMT Message-ID: <19980318092925.09911@iii.co.uk> Date: Wed, 18 Mar 1998 09:29:25 +0000 To: Sue Blake Cc: Studded , doc@FreeBSD.ORG, "Jordan K. Hubbard" Subject: Re: Documentation plan - handbook, etc. References: <350CF5E6.5DD147F5@dal.net> <7061.890049804@time.cdrom.com> <19980316153125.64380@iii.co.uk> <350E3B8A.F440FBD0@dal.net> <19980317093137.48803@iii.co.uk> <19980318073552.00770@welearn.com.au> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.85e In-Reply-To: <19980318073552.00770@welearn.com.au>; from Sue Blake on Wed, Mar 18, 1998 at 07:35:52AM +1100 Organization: interactive investor Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Mar 18, 1998 at 07:35:52AM +1100, Sue Blake wrote: > > Yes. Off the top of my head the conversion process will allow HTML, PDF, > > PS, plain ASCII and RTF. Right *now*, I don't fully understand the method > > necessary to turn DocBook mark up into TeX. Once it's in TeX it can then > > be converted to PS and PDF (via DVI). > > Does the PDF conversion produce a document with bookmarks and hyperlinks? Apparently. I haven't got the PDF conversion stuff sorted yet, because I've only just started to get to grips with the TeX conversion. See Hopefully my earlier message to this list contained enough information so that those folks that know TeX but don't know Jade can get started and offer up some advice. > I have reservations about PDF because not everyone has the browser, but > if PDF is used, it should have its most useful features enabled. Apparently > some windoze victims seem to think it's a good idea, and it prints well. I agree. Keep in mind though that PDF will be just one of a number of formats. One of the advantages of using SGML is that it is not tied to any one platform and/or viewer. Adding new target formats just needs one motivated person to write the backend. There's no particular reason (other than time) that there couldn't be a *roff backend to Jade, for example. > In particular, a PDF version of the handbook would be worth the effort of > doing well. So much so that I'd be prepared to add the links with this > hideous little Adobe app that's hiding on my NT partition, if your > conversion process doesn't do it all. The input could be ps or pdf or rtf. That (hopefully) won't be necessary. Incidentally, I did a test run with the current Handbook after doing a quick and dirty conversion to DocBook. It works out at roughly 380 pages of A4. . . N -- Work: nik@iii.co.uk | FreeBSD + Perl + Apache Rest: nik@nothing-going-on.demon.co.uk | Remind me again why we need Play: nik@freebsd.org | Microsoft? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message