Date: Sun, 7 Apr 2002 16:38:09 +0100 From: Nik Clayton <nik@freebsd.org> To: Murray Stokely <murray@FreeBSD.org> Cc: Giorgos Keramidas <keramida@freebsd.org>, freebsd-doc@freebsd.org Subject: Re: Splitting the Handbook? (was: [a couple of new doc PRs]) Message-ID: <20020407163809.R30474@canyon.nothing-going-on.org> In-Reply-To: <20020406231126.GP5732@freebsdmall.com>; from murray@FreeBSD.org on Sat, Apr 06, 2002 at 03:11:26PM -0800 References: <20020404062954.6607E2E827@mail.freebsdmall.com> <20020406221709.GA1181@hades.hell.gr> <20020406231126.GP5732@freebsdmall.com>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --]
On Sat, Apr 06, 2002 at 03:11:26PM -0800, Murray Stokely wrote:
> On Sun, Apr 07, 2002 at 01:17:09AM +0300, Giorgos Keramidas wrote:
> > This is hard to search though. It's difficult for a newcomer to find his
> > way around in this huge document. It is time, I think to separate the
> > Handbook in smaller parts. The main thing that I was thinking about is how
>
> It's been time for over 4 years, we've just never identified the
> first concrete step to move in that direction.
Each chapter becomes its own book, with a copy of the content in the
existing Preface as its own Preface.
Pretty much.
> I think that the 3rd printed edition (which I've obviously been
> doing some initial planning for) should be split into two books along
> these lines. I was planning on a "User's Guide" and an
> "Administrator's Guide". If the FreeBSD Documentation Project makes
> further subdivisions into smaller books, they can be mapped into these
> two categories for print publication purposes. A collection of
> smaller books is not practical for U.S. retail shelves, although if
> done right it can make online browsing easier.
For print, you want the DocBook <set> element.
<set>
<book>...</book>
<book>...</book>
<book>...</book>
...
</set>
*or* some XSLT stylesheets that can maps the <set> to a <book>, the
<book>s to <chapter>s, and so on.
Eventually, the "FreeBSD Handbook" becomes the "FreeBSD Bookshelf".
Now, if I could just get funding :-)
N
--
FreeBSD: The Power to Serve http://www.freebsd.org/ (__)
FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',)
\/ \ ^
--- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/_)
[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (FreeBSD)
Comment: For info see http://www.gnupg.org
iEYEARECAAYFAjywZ+AACgkQk6gHZCw343UFuwCfW/XfADXilqJk2PXIo6oB6ZZO
flsAn3ZmhbDAk+s+tNl/PCJmSF4jrt16
=gLnb
-----END PGP SIGNATURE-----
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020407163809.R30474>