From owner-freebsd-doc Tue Mar 10 02:40:15 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id CAA04103 for freebsd-doc-outgoing; Tue, 10 Mar 1998 02:40:15 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from ns1.yes.no (ns1.yes.no [195.119.24.10]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id CAA04098 for ; Tue, 10 Mar 1998 02:40:12 -0800 (PST) (envelope-from eivind@bitbox.follo.net) Received: from bitbox.follo.net (bitbox.follo.net [194.198.43.36]) by ns1.yes.no (8.8.7/8.8.7) with ESMTP id KAA21863; Tue, 10 Mar 1998 10:40:10 GMT Received: (from eivind@localhost) by bitbox.follo.net (8.8.6/8.8.6) id LAA08692; Tue, 10 Mar 1998 11:40:09 +0100 (MET) Message-ID: <19980310114009.12079@follo.net> Date: Tue, 10 Mar 1998 11:40:09 +0100 From: Eivind Eklund To: nik@iii.co.uk, Albert School Cc: freebsd-doc@FreeBSD.ORG Subject: Re: DocBook, SGML...Newbie Question References: <01IUGQVVKC4Y8X125F@hermes.medctr.ohio-state.EDU> <19980310101344.39601@iii.co.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89.1i In-Reply-To: <19980310101344.39601@iii.co.uk>; from nik@iii.co.uk on Tue, Mar 10, 1998 at 10:13:44AM +0000 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Mar 10, 1998 at 10:13:44AM +0000, nik@iii.co.uk wrote: > I'm going to try and put together more of a tutorial over the next few > weeks. If you get the opportunity to make any notes as you're learning > this stuff, please pass them on. Notes: Finding DSSSL stylesheets for DocBook is quite a bit of work. They're at http://www.berkshire.net/~norm/docbook/dsssl/index.html The TeX generated by Jade should probably change. More work should happen in the DSSSL end instead of the TeX end. jadetex is difficult to install, and might be a good candidate for a port. Problem: I can't do a port, as I wasn't able to ever get it to work properly. It is not trivial to find a good conversion from DocBook to printed matter. No publically available conversion system seems to handle screenshots. DocBook is difficult to get into. It would probably be beneficial for FreeBSD to have a 'limited set' markup that can be used by beginners to actually get them to write documentation, instead of having them struggle with learning DocBook. This format should be able to produce decent quality output, but not be as flexible or as good as DocBook. Conversion could be done when the author feel up to it (or some old hand feel like actually doing it). These are off the top of my head; I'll try to find my actual notes, too. Eivind. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message