From owner-freebsd-doc  Mon Jul 24 12: 6:18 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66])
	by hub.freebsd.org (Postfix) with ESMTP
	id 6F08A37BD7D; Mon, 24 Jul 2000 12:06:10 -0700 (PDT)
	(envelope-from nik@nothing-going-on.demon.co.uk)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA68609;
	Mon, 24 Jul 2000 19:35:22 +0100 (BST)
	(envelope-from nik)
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>
References: <200007211630.JAA10561@freefall.freebsd.org> <20000721225213.B51580@ark.cris.net> <20000722064931.M64132@strontium.scientia.demon.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20000722064931.M64132@strontium.scientia.demon.co.uk>; from ben@FreeBSD.org on Sat, Jul 22, 2000 at 06:49:31AM +0100
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

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