Automatic TOC on Wiki pages as found in DokuWiki

[Ian Leader <___ian.leader___@…>]

Ticket #771 mentions the very cool automatic TOCs in ​DocuWiki

Our team would find these very useful as it has become hard to find information on some of our pages as they have got rather long.

[straider]

IMHO, the automatic floating TOC is great, but that's just one of the best features that small PHP engine has, when compared with others. Ticket 771 was closed, and I must agree with its resolution. Nevertheless, by comparing the features between each WikiEngine, one could then pin-point the items of a Trac-FeaturesWishList with more accuracy. Please, see and update the comparision page accordingly, at ​http://www.splitbrain.org/dokuwiki/wiki%3Acompare.

[___ian.leader___@…]

on the subject of the resolution to ticket 771 - I agree that rst is much more powerful than a ToC floating at the top of the page - but with that power comes complexity. Most people updating our Trac Wikis (even the technical people) simply want to bash out some quick doco using the basic Wiki commands.

As people are already putting in different levels of heading, it seems that Trac is missing a trick by not having an automatic ToC - unless, of course their is a macro that we can slap at the top of the page to generate a ToC form normal heading Wiki markup (in which case we're the ones missing the trick) - that said I still think having it as an integral part of the system would be better.

[trac-form@…]

The TOC macro, linked on the MacroBazaar page, does exactly what Ian proposes.

[Christopher Lenz]

The [[PageOutline]] macro provides this in 0.9 (well, trunk).

You need to put the macro in manually, but that has the advantange that you don't have the box on pages where you might not want it.

[Christian Parpart <trapni@…>]

PageOutline seems to be already in /usr/lib/python2.3/site-packages/trac/wiki/macro.py and I've found no other place where I shall explicitely load it from, but yet, adding a

line on top of the page doesn't show any of the results…. why?

[Christian Parpart <trapni@…>]

Man! Hit me! it's been on the right side of the page *g*… simply ignore my comment ;)