Date: Thu, 2 Nov 2000 11:39:15 +0000 From: Nik Clayton <nik@freebsd.org> To: David Johnson <djohnson@acuson.com> Cc: Brian Raynes <brian_raynes@dnr.state.ak.us>, freebsd newbies <freebsd-newbies@freebsd.org> Subject: Re: A sample category Message-ID: <20001102113915.A2196@canyon.nothing-going-on.org> In-Reply-To: <3A00B07C.1692EA57@acuson.com>; from djohnson@acuson.com on Wed, Nov 01, 2000 at 04:08:28PM -0800 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>
next in thread | previous in thread | raw e-mail | index | archive | help
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).
<sect1 id="audio">
<title>Audio</title>
<variablelist>
<varlistentry>
<term><application>xmms</application></term>
<listitem>
<para><application>xmms</application> ... </para>
<para>...</para>
<listitem>
</varlistentry>
<varlistentry>
...
</varlistentry>
...
</variablelist>
> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20001102113915.A2196>