Date: Mon, 24 Jul 2000 19:35:21 +0100 From: Nik Clayton <nik@freebsd.org> To: Ben Smithurst <ben@FreeBSD.org> Cc: Alexey Zelkin <phantom@cris.crimea.ua>, freebsd-doc@FreeBSD.ORG Subject: Re: docs/20056: Bad SGML in the "@ sign" entry of the FAQ Message-ID: <20000724193521.B57387@catkin.nothing-going-on.org> In-Reply-To: <20000722064931.M64132@strontium.scientia.demon.co.uk>; from ben@FreeBSD.org on Sat, Jul 22, 2000 at 06:49:31AM %2B0100 References: <200007211630.JAA10561@freefall.freebsd.org> <20000721225213.B51580@ark.cris.net> <20000722064931.M64132@strontium.scientia.demon.co.uk>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Jul 22, 2000 at 06:49:31AM +0100, Ben Smithurst wrote:
> >> I'll be axing all man.cgi unless anyone on -doc objects...
> >
> > Reason ?
>
> Consistency with the other docs, mainly. Though if you think they
> should stay, I'll leave them.
>
> >From the handbook,
>
> revision 1.29
> date: 1998/08/25 09:06:27; author: nik; state: Exp; lines: +196 -168
> <ulink url="...man.cgi?...">...</ulink> -> <citerefentry>...</citerefentry>
>
> I'm guessing Nik had a good reason, so if he tells me that, I'll use
> that as my reason. :-)
It should be possible to write some DSSSL that turns the <citerefentry>
stuff into appropriate man.cgi references. Actually, I've been meaning
to do this for some time. . .
[ Time passes. Thorin starts singing about gold. . . ]
OK, try putting the following DSSSL in to the %output.html; section of
freebsd.dsl.
------------ 8< ------------ 8< ------------ 8< ------------ 8< ------------
<!-- Convert <citerefentry> into links to man.cgi -->
(element citerefentry
(let ((ref (select-elements (descendants (current-node))
(normalize "refentrytitle")))
(vol (select-elements (descendants (current-node))
(normalize "manvolnum"))))
(make element gi: "a"
attributes: (list (list "href" (string-append
"http://www.FreeBSD.org/cgi/man.cgi?"
(data (node-list-first ref))
"("
(data (node-list-first vol)) ")")))
(process-children))))
------------ 8< ------------ 8< ------------ 8< ------------ 8< ------------
To do this properly we'd probably a mancgi-links variable that would default
to #f, and the stylesheets can set that to #t as necessary.
That's probably not the most efficient way to do things. But it's a start.
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-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000724193521.B57387>