From owner-freebsd-newbies Thu Nov 2 3:40:42 2000 Delivered-To: freebsd-newbies@freebsd.org Received: from nothing-going-on.demon.co.uk (unknown [194.128.198.234]) by hub.freebsd.org (Postfix) with ESMTP id E88E137B479 for ; Thu, 2 Nov 2000 03:40:37 -0800 (PST) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.0/8.11.0) id eA2BdFx02264; Thu, 2 Nov 2000 11:39:15 GMT (envelope-from nik) Date: Thu, 2 Nov 2000 11:39:15 +0000 From: Nik Clayton To: David Johnson Cc: Brian Raynes , freebsd newbies Subject: Re: A sample category Message-ID: <20001102113915.A2196@canyon.nothing-going-on.org> References: <39FF634E.48ADADF3@acuson.com> <39FF6DA5.6A9F28BF@dnr.state.ak.us> <3A006787.C170BFAC@acuson.com> <3A006FCC.B78140FA@dnr.state.ak.us> <3A008601.4E984627@acuson.com> <3A00A4F3.74C2C615@dnr.state.ak.us> <3A00A8C8.2F1D32F3@acuson.com> <3A00AD9C.33D30721@dnr.state.ak.us> <3A00B07C.1692EA57@acuson.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <3A00B07C.1692EA57@acuson.com>; from djohnson@acuson.com on Wed, Nov 01, 2000 at 04:08:28PM -0800 Organization: FreeBSD Project Sender: owner-freebsd-newbies@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Nov 01, 2000 at 04:08:28PM -0800, David Johnson wrote: > Brian Raynes wrote: > > After a little thought, I think the DocBook idea is a little better. > > I don't know much about DocBook, but isn't it easy to create html, pdf > > and ps files from DocBook format? "Easy" is a relative term. Now that I know what I'm doing, it's pretty easy. There was a fair share of pain along the way though. > > I've really liked the way the > > handbook and a few other docs have been distributed this way. Thanks (nik@freebsd.org == Documentation Project Manager). > > I'm not > > sure I've ever seen comments handled in document form, but for all the > > other information the document format seems easier to setup than a > > website and might require fewer resources (hardware & bandwidth). Audio xmms xmms ... ... ... ... > The FDP (FreeBSD Documentation Project) has a great manual on using > DocBook. http://www.freebsd.org/tutorials/docproj-primer/ Add "book.html" to the end if you prefer one big HTML file. > I used it for my own documentation on one of my projects and it > was pretty slick. Using jade and dsssl, I created my html doc in 5 > seconds. I didn't have TeX installed at the time, or I could have > created dvi, ps and pdf just as easily. Good to know that people are finding it useful. > Read the FDP documentation, as > the docs of Jade are pretty dense and incomplete. The O'Reilly DocBook > book is wonderful, and if you don't want the dead tree version, it's > also online for free. At http://www.docbook.org/ N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-newbies" in the body of the message