FreeLists / dokuwiki / [dokuwiki] Re: How to number headlines ?

[Ben Coburn <btcoburn@xxxxxxxxxxxxx>]

On Apr 5, 2006, at 4:20 PM, Chris Smith wrote:

> Chris Smith wrote:
> > It needs modifications to parts of the parser to work properly.
> > (1) Changes to header / section handling.  I reckon they are 
> > improvements over the current methods so I'll package them up in a 
> > patch for Andi to look at.
>
> Quick question before I do this.
>
> At present, p_get_first_heading()  (inc/parserutils.php) gets the 
> first heading information by searching the document for the first 
> header instruction.  This works fine if your headers come from the 
> dokuwiki native heading handler, but fails if headings are provided by 
> some other mechanism.
>
> Its also potentially inefficient as it needs to search the instruction 
> list for a page until it find that first heading.
>
> How about:
> (1) adding a new piece of meta data, meta['first_heading'].  If the 
> value is empty, the native header syntax will fill that with the first 
> heading it comes across.  Any alternate method of handling headings 
> can do the same.  Then as long as everything behaves well, there will 
> be no clashes and the first heading can be set by anything.
>
> (2) the first heading information gets added as the first instruction 
> in the list by the _finalise handler.  This would guarantee that the 
> first heading information is quickly accessible in every document.
>
> Taking this a step further, could all the page meta data get added to 
> the first instruction in the page.  This opens up the possibility for 
> native syntax modes and plugins to add page settings information in a 
> controlled manner that could be used by other parts of dokuwiki simply 
> by reading the first instruction.[1]

How about adding all of the heading information to the "meta" data on 
the front of the instruction list? Currently, rendering the subsection 
edit buttons in any other location (or with other semantics) requires 
information the renderer has not yet read in from the instruction list.

I propose that this meta-information include the list of headings (in 
order) with their starting position ($pos), depth, and (optionally) the 
heading text. This would allow the renderer to produce section edit 
button in both a flexible and efficient manner. I imagine it might also 
help with the TOC.

Regards, Ben Coburn


-------------------
   silicodon.net
-------------------

--
DokuWiki mailing list - more info at
http://wiki.splitbrain.org/wiki:mailinglist