Return-Path: 
 <forrest-dev-return-4690-apmail-xml-forrest-dev-archive=xml.apache.org@xml.apache.org>
Delivered-To: apmail-xml-forrest-dev-archive@xml.apache.org
Received: (qmail 79385 invoked by uid 500); 27 Jan 2003 06:50:54 -0000
Mailing-List: contact forrest-dev-help@xml.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:forrest-dev-help@xml.apache.org>
list-unsubscribe: <mailto:forrest-dev-unsubscribe@xml.apache.org>
list-post: <mailto:forrest-dev@xml.apache.org>
Reply-To: forrest-dev@xml.apache.org
Delivered-To: mailing list forrest-dev@xml.apache.org
Received: (qmail 79376 invoked from network); 27 Jan 2003 06:50:53 -0000
Received: from smtp3.ihug.com.au (203.109.250.76)
  by daedalus.apache.org with SMTP; 27 Jan 2003 06:50:53 -0000
Received: from p416-apx1.syd.ihug.com.au (expresso.localdomain)
 [203.173.141.162]
	by smtp3.ihug.com.au with esmtp (Exim 3.22 #1 (Debian))
	id 18d36k-0006fH-00; Mon, 27 Jan 2003 17:51:03 +1100
Received: from jeff by expresso.localdomain with local (Exim 3.35 #1 (Debian))
	id 18d3Ab-00046W-00
	for <forrest-dev@xml.apache.org>; Mon, 27 Jan 2003 17:55:01 +1100
Date: Mon, 27 Jan 2003 17:54:56 +1100
From: Jeff Turner <jefft@apache.org>
To: forrest-dev@xml.apache.org
Subject: Re: intra-FAQ links
Message-ID: <20030127065455.GA12591@expresso.localdomain>
Mail-Followup-To: forrest-dev@xml.apache.org
References: <3E346B6D.7080307@yahoo.de>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <3E346B6D.7080307@yahoo.de>
User-Agent: Mutt/1.4i
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

On Mon, Jan 27, 2003 at 12:12:45AM +0100, J.Pietschmann wrote:
> Hi there,
> we have some links within our FAQ, pointing to other questions.
> Unfortunately, the links don't appear to work. I guess this is
> because we use for example
>   <faq id="postquestions">
> and
>   <link href="#postquestions">...
> 
> In faq2document.xsl, the relevant template seems to be
>    <xsl:template match="faq">
>     <anchor id="faq-{generate-id()}"/>
>     <section>
>     ...
> It is not obvious an anchor for the question's ID is
> generated.
> 
> Q: Should't an anchor be generated for, well, basically
> everything? In doc-v11.mod there is a comment:
>    <!-- Common attributes
>         Every element has an ID attribute (sometimes required,
>         but usually optional) for links.
>    ...
> It's not of much use if the style sheets ignore it...
> 
> Are there other ways to make intra-FAQ links work?
> 
> And, well, the skinning of FAQs could use some improvement.
> I'd like have the faqsections (damn, *parts*) numbered,
> as well as the questions within the sections. Also, some
> indendation would really help to keep track which text belongs
> to which question.

Fixed.

> Well, another flaw:
>   <xsl:template match="faq">
>     <anchor id="faq-{generate-id()}"/>
>     <section>
>      <title>
>       <xsl:value-of select="question"/>
>      </title>
> The DTD allows inline markup in questions, therefore it would
> be appropriate to use xsl:apply-templates.

Fixed.

> A patch for most of the above:
>   <xsl:template match="faq">
>     <anchor id="faq-{generate-id()}"/>
>     <xsl:if test="@id">
>       <anchor id="{@id}"/>
>     </xsl:if>
>     <section>
>      <title>
>        <xsl:number level="multiple" count="faq|part" format="1.1. "/>
>        <xsl:apply-templates select="question"/>
>      </title>
> 
> Well, the xsl:number part is completely untested...

Worked nicely, and now committed.

http://forrestbot.cocoondev.org/sites/xml-forrest/faq.html


--Jeff
> 
> J.Pietschmann
>