OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook-apps] Indexterms in FAQ Questions result in duplicate text?


You have run into one of the compromises that the stylesheet has to make for
HTML.  In the case of the QandA table of contents, it processes the question
element by using <xsl:value-of> on the first child element of <question>.
That gets just its string value, and so the indexterm text is included.  It
gets the string value because it puts it inside an HTML <a> element. Since a
question element can contain arbitrary content, including other cross
references, that would lead to bad HTML because you can't nest links within
links in HTML.

You can work around the problem by putting the <indexterm> after the closing
</para> tag within the <question>.  That way it will not be included in the
first child of question, and it should still work.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Robert A. Ballance" <raballa@sandia.gov>
To: <docbook-apps@lists.oasis-open.org>
Sent: Tuesday, June 08, 2004 2:01 PM
Subject: [docbook-apps] Indexterms in FAQ Questions result in duplicate
text?


> If I put an <indexentry> into an FAQ <question>,  the index term gets
> duplicated in the list of questions in the HTML output.
>
> Configuration:  Saxon, Docbook 4.2 XML, and the Docbook-XSL stylesheets
> 1.65.1
>
> Example:
>
> <question>
> <para>
> Can I use
> <indexterm><primary>OOPS</primary></indexterm> docbook as my
> documentation standard?
>    </para>
> </question>
>
> gives the following output in the list of questions
>
> Q:
> Q: Can I use OOPS docbook as my documentation standard?
> Q:
>
> but
> Q: Can I use docbook as my documentation standard?
> A: ...
>
> in the full sequence.
>
> ... Bob Ballance
>
>
>
> To unsubscribe from this list, send a post to
docbook-apps-unsubscribe@lists.oasis-open.org, or visit
http://www.oasis-open.org/mlmanage/.
>
>
>




[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]