Date: Fri, 22 Jun 2001 09:42:01 +0100 From: Nik Clayton <nik@freebsd.org> To: Murray Stokely <murray@osd.bsdi.com> Cc: freebsd-doc@FreeBSD.org Subject: Re: Author attributions in the FreeBSD Handbook Message-ID: <20010622094201.L8380@clan.nothing-going-on.org> In-Reply-To: <20010621174721.A54523@meow.osd.bsdi.com>; from murray@osd.bsdi.com on Thu, Jun 21, 2001 at 05:47:21PM -0700 References: <20010621174721.A54523@meow.osd.bsdi.com>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] On Thu, Jun 21, 2001 at 05:47:21PM -0700, Murray Stokely wrote: > Currently, the Handbook is covered with some rather inconsistent > author attributions at the beginning of most sections and many > subsections. Some of these attributions appear before the synopsis, > others are part of the synopsis. Also, these attributions just sort > of informally appear in <para> and <emphasis> tags instead of an > <author> tag of some sort. Does anyone have any ideas about the best > way to clear up this situation? Using <authorblurb> tags as I've done > below allows the HTML output to look the same but I'm not sure this is > the correct way to do it. This has come up before, IIRC. For DocBook 3.1 documents use <docinfo>, which can contain an <authorgroup>, where you can add all sorts of authorship information. For DocBook 4.1 documents use <chapterinfo>, <prefaceinfo>, and similar, depending on the containing element. The problem with this is that, by default, the stylesheets won't show the content of <chapterinfo> and the like. They need to be to be slightly rewritten to support this. Are you, or anyone else from WRS working on this, going to be at Usenix. I'm there all next week, and it might be worth spending a morning or afternoon sat down working through issues like this (which, I'm guessing, have come up again in re printing the handbook). 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 iEYEARECAAYFAjszBNkACgkQk6gHZCw343XDIQCfdWr2AsR5nDL7PJ12sTJaELSI LbYAnjkgXkipz/XdicGp7vaaRHWrkqHu =AWOF -----END PGP SIGNATURE-----help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010622094201.L8380>