[pmwiki-users] Core TOC (Was: PmWiki 2.1.12 released)

[John Rankin]

On Thursday, 10 August 2006 9:36 AM, christian.ridderstrom at gmail.com wrote:
>On Tue, 8 Aug 2006, Tegan Dowling wrote:
>
>> http://pmwiki.org/wiki/PITS/00027
>
>The page has this now...
>
> 	Priority: 55555 55555 55555 55543 3
>
>That has to be one of the more popular requests!
>
>Patrick asked for some "fleshing out of the basics", so how about some 
>discussion on what we'd like from a TOC. The basic assumption is probably 
>that functionality should be pretty basic, and the extra stuff will go 
>into recipes. John's TOC recipe is of course a good page now:
>
> 	http://www.pmichaud.com/wiki/Cookbook/PageTableOfContents
>
>As for me I use John's recipe in this way >90% of the time:
>
> 	(:toc:)		- Just produce a TOC

Same here!

I also note Christian's modesty. For those readers who are
newish to the list, the main reason that toc works as smoothly
as it does is because Christian carried out exhaustive testing
and made innumerable excellent suggestions as to how it should
work. He gave me many "he's right, but how on earth am I going
to make it work that way" and "yuk, that's not right" moments.
>
>And sometimes.
>
> 	(:toc Table of Contents:)	- To get a new TOC title
>
>Btw, I wouldn't be adverse to letting the syntax of the last become one of 
>these:
>
> 	(:toc title="Table of Contents":)
> 	(:toc heading="Table of Contents":)
>
>cheers
>/C
>
Yes, I really need to bring the syntax into line with PmWiki 2 
conventions. The code can also be simplified -- it should now 
be able to insert * start of line markup instead of doing its 
own <ol><li> thing. And that will I think make it easier to 
add a level=n parameter, where n is the depth of toc. At the 
moment it always does level=2.

-- 
JR
--
John Rankin