Re: [docbook-apps] Q&A sets within an article: How to insert QandASet title to the article TOC

From
Zbyszek Cybulski <>
Date
2006-01-27T07:34:04+00:00
ID
Thread
Re: [docbook-apps] Q&A sets within an article: How to insert QandASet title to the article TOC
Thank you, Bob.

I already though it could not be solved. I see a lot of learning ahead :)

Regards,

Zbyszek

On 1/26/06, Bob Stayton
 <> wrote:

Hi,

You can customize the template named 
'component.toc' from html/autotoc.xsl.  It calls a template named 
'make.toc' with a parameter named 'nodes', which selects what elements to 
include in the toc.  If you add qandaset to the selection for 'nodes', you 
should get them in your article toc.

 

Bob Stayton
Sagehill Enterprises
DocBook Consulting


 

 

  
----- Original Message ----- 

  

From: 
  Zbyszek 
  Cybulski 

  
To: 
DocBook Apps 

  
Sent: Wednesday, January 25, 2006 3:41 
  AM

  
Subject: [docbook-apps] Q&A sets 
  within an article: How to insert QandASet title to the article TOC

  

Hi list,

my problem is as in the message 
  subject.

I have an article, like below:

<article 
  class="faq">
    
  <articleinfo>
        
  <title>FAQ</title>
        
  <subtitle>something</subtitle> 
  
        <releaseinfo>Release 
  number</releaseinfo>
    
  </articleinfo>
    <xi:include 
  href=""qa1.xml"/>    <xi:include 
  href=""qa2.xml"/>    <xi:include href=""" 
  qa3.xml"/>
</article>

Each XIncluded file is a QandASet, 
  like the following:

<qandaset 
  id="general_security">
    <title>Security 
  issues</title>
    <qandaentry id="forgot_pwd"> 
  
        
  <question>
            
  <para>I forgot my password. How can I retrieve 
  it?</para>
        
  </question>
        
  <answer><para>The answer 
  is...</para>
        
  </answer> 
    
  </qandaentry>
</qandaset>

How do I define my 
  customization layer to have the HTML output similar to the 
  following?

FAQ
something
Release 
  number
------------------------------- 
Table of 
  Contents

Security issues
QASet2 title
QASet3 
  title

--------------------------------
Security issues
1. I 
  forgot my password. How can I retrieve it?
2. Q2

QASet2 
  title
1. Q1
2. Q2

QASet3 title
1. Q1
2. Q2

I 
  have set <xsl:param name="generate.toc">article toc,title qandaset 
  toc</xsl:param>, but it does not work. That is, questions are listed 
  within each Q&ASet but I do not see article's ToC. 

I can accept 
  the following output or any combination of it that will provide the article 
  ToC:

FAQ
something
Release 
  number
-------------------------------
Table of Contents

Security 
  issues
    1. I forgot my password. How can I retrieve 
  it?
    2. Q2
QASet2 title
    1. 
  Q1
    2. Q2
QASet3 title
    1. 
  Q1
    2. Q2
--------------------------------
Security 
  issues
1. I forgot my password. How can I retrieve it?
2. 
  Q2

QASet2 title
1. Q1
2. Q2

QASet3 title
1. 
  Q1
2. Q2

Thanks in 
advance,

-Zbyszek