[pmwiki-users] Re: Table of Contents (Was: ) picks up Q:-markup)

chr at home.se chr at home.se
Wed Jan 26 08:54:43 CST 2005


On 26 Jan 2005, John Rankin wrote:

> >> >I just noticed that (:toc:) picks up Q:-markup and includes it into the 
> >> >TOC. Is this really the correct behaviour?
> >> 
> >> Yes; this is a feature. It lets you create a toc to a faq page, for example.
> > 
> >My question is how I *deactivate* this feature :-)

> Thinking out loud, I see 3 obvious and easy options:
> 
> 1 we make the question markup character a configurable variable, that
>   defaults to 'Q' -- an administrator can then disable this by setting
>   the value to (say) 'Z' (of course any Z: start of line markup will
>   be included in the toc)

Nah.. seems too much of a hack.

> 2 an administrator introduces q: markup with the same effect as Q:
>   except that questions will be omitted from the toc -- or one could 
>   make it QQ: ('quiet question') or Q*: -- whatever is most natural

Hmm... I'd thought that 'Q*:' was for the question to be included as an 
unnumbered item, and 'Q#:' for it to be enumerated. *If* we want to 
control this individually.

> 3 we omit Q: markup from toc; if an author wants to include a
>   question, use Q*: markup (or some other natural markup)

Oh.. maybe I should read all you write before answering.. guess I've just 
agreed with this.

> We might even do the following:
> 
> if $TocIncludesQuestions is true,
>     Q: is included
>     Q*: is excluded
> 
> if $TocIncludesQuestions is false
>     Q: is excluded
>     Q*: is included

Would work for me.
 
> So my question back is: Do you want to deactivate this
> 
> - for all questions
> 
> - for some questions
> 
> - on all pages
> 
> - on some pages

In this particular case I had lots of sections and I didn't want any 
questions to make it into the list. OTOH, wiki.lyx.org would probably want 
questions to be included in the TOC for at least the FAQ-group.

So the answer would be that I'd want questions (Q:) to be included on some 
pages, but not on all. 

/Christian

-- 
Christian Ridderström, +46-8-768 39 44               http://www.md.kth.se/~chr





More information about the pmwiki-users mailing list