• View
• Edit
• History
• Attach
• Print

00027

Description: Adding of a Table of Contents tag to the standard distribution of PmWiki. Something like PageTableOfContents would be great.

Given the existence of the cookbook script, I'm not quite ready to make this a part of the standard distribution. It needs a few more priority votes and some fleshing out of the basic concepts.

--Pm

Suggestions

• the toc entries are Links to the headings
• <Toc Auto Depth> variable to define the heading depth that gets displayed like: (:toc 2 5:)
• possibility to display the toc in a other page (for example in a sidebar) without the constraint to have the directive also in the target page
• either replicate all the functionality of Cookbook.PageTableOfContents or write it in a way that a cookbook recipe can add just the missing features
• the headings has a link to the toc

more general suggestion

• Compatible to Cookbook.NumberedHeaders
• if there is a link form the toc to the heading, there will be a anchor on the heading. To have a anchor on every heading in pages per default (not with the anchor markup) could be very useful. Maybe, it could be a way to make a script for building automatically anchors on headings (setable for all pages or just for pages with a toc) and a toc script that makes a list of headings with a link to it. noskule

It's also worthy of note that TOC is a core feature in many currently popular wiki engines (e.g. MediaWiki, Dokuwiki). MateuszCzaplinski

Actually I think PageTableOfContents is the wrong model for a ToC core candidate. I'd like to see it based on the pagelist concept, except it applies to anchors in a page. Since the pagelist area is being reviewed (eg looking at including attachments as well) possibly generating lists of anchors would not be too far fetched. Elsewhere (PITS.00955) it has been suggested that anchors be generated automagically for all heading, something I'd like to see. Together these two suggestions would provide the solution. simon October 16, 2009, at 11:28 PM

Being less implicit would make life easier

Request moved from PmWiki:InitialSetupTasks-Talk.

I add the following to this talk page because every time I setup a new PM-Wiki same things popup into my brain and hurts it. Don't get me wrong: I love PM-Wiki otherwise I would use another wiki. In most cases its pretty easy to use ...but It there are some issus make me go crazy:

Why this hand made TOCs

A lot of pages offer "hand made" Table Of Contents - Well.. it might be a good idea to define by wiki-syntax what should appear in a TOC..BUT if I would like to have a TOC anywhere (especially those floating boxes) and how the look and was formatted should be configurable.

Why don't you use some more .tmpl Files for those things with has to have a placeholder where the generated list is inserted. Anyway.. the way its done now is not a real help to get a nice clean looking wiki.

It would be help enough to give all TOCs an unique CSS class so anyone who don't like em can easily hide em by display:none;.

Jan Bernitt?