Date: Sun, 4 Apr 2004 15:44:14 +0200 From: "Simon L. Nielsen" <simon@FreeBSD.org> To: Ceri Davies <ceri@FreeBSD.org> Cc: freebsd-doc@freebsd.org Subject: Re: Glossary [was: docs/64144: [patch] document procedure to add a new ports category to Committer's Guide] Message-ID: <20040404134413.GB2933@zaphod.nitro.dk>
next in thread | raw e-mail | index | archive | help
--ftEhullJWpWg/VHq Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable [CC trimmed even more for new topic. Second try, which hopefully won't be caught by spam filters] On 2004.04.02 02:27:26 +0100, Ceri Davies wrote: > Regarding the glossary, how does everyone think that's working out? I > notice that it's been short of attention recently and wanted to check > that people still think it's a nice idea before I do some work on it. Even though it hasn't been getting much attention I still think it's a very good idea. > My current thinking at the moment is to do away with the > FreeBSD-specific aspect and make it more general, then fiddle the You mean make it both FreeBSD and general? That would probably be a good idea, and also give the glosserary a better reason for for existing if it has more actual content. > stylesheets to create links to the glossary term for firstterm and > acronym elements That sounds like a real neat idea. Acronyms can appear many times on one page, so perhaps only the first occurrence on a page should be marked up with a link. Eg. like only the first occurrence a trademark on a page gets the trademark symbol. > (once I've worked my way through Teach Yourself Scheme > in Fixnum Days [1]) and, perhaps, eventually one day it will be an error Uhh Scheme... Just make sure you have spare keyboard laying around when you parenthesis keys gets worn out ;-). > to add one of those elements without a matching glossary entry. Much as > I love it when a plan comes together, this will probably take a while, > and I want to check the water before I dive in. Sounds like a good plan to me. > [1] http://www.ccs.neu.edu/home/dorai/t-y-scheme/t-y-scheme.html for > those who may be interested. That was also one of the tutorials I used when I made the trademark stylesheet stuff. Others I used was http://www.netfolder.com/DSSSL/index.html and http://coli.lili.uni-bielefeld.de/Texttechnologie/dsssl_ma/dsssl/index.html= . --=20 Simon L. Nielsen FreeBSD Documentation Team --ftEhullJWpWg/VHq Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFAcBEth9pcDSc1mlERAloYAJ4lumQqfizbihp8EfuyoXfdJwXhvQCfQlM1 nFCimXjl81lZDjuOeRBM0n0= =F3Rr -----END PGP SIGNATURE----- --ftEhullJWpWg/VHq--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040404134413.GB2933>