[pmwiki-users] Automatically add anchors to heading tags? pmwiki-users Digest, Vol 25, Issue 50
john.rankin at affinity.co.nz
Wed Jul 25 17:34:35 CDT 2007
On Monday, 23 July 2007 2:14 PM, pmwiki-users-request at pmichaud.com wrote:
> 9. Re: Automatically add anchors to heading tags?
> (christian.ridderstrom at gmail.com)
>>>> Is there a simple way to configure pmWiki such that all headings (H1,
>>>> H2, etc) are automatically generated with anchor tags so people can
>>>> link directly to a section or subsection? (I believe MediaWiki has
>>>> this functionality by default.)
>>> Now officially a requested feature. Vote / comment here:
>> I left some questions on the PITS page, but essentially:
>> * What if the heading contains other markups, such as links
>> or wikistyles? Do we have to be smart enough to strip those
>> somehow before producing the heading anchor?
>> * If a heading already has an anchor in it, should PmWiki
>> still generate yet another anchor for the heading?
>> * Do we convert all punctuation that appears in the heading,
>> or just parens?
>I tried finding the recipe 'visible anchors' that I thought I'd uploaded
>to the cookbook a long time ago (pmwiki v1), but maybe it got incorporated
>into John's PageToC.
It did; the (:toc anchors=visible:) option.
>I don't think it's a great idea to use the heading text to generate the
>label. My recommendation is to enumerate them instead. If we worry that an
>enumerated heading becomes incorrect if a heading is inserted before it,
>remember that a similar thing happens if you change the heading
Turning heading text into an anchor guaranteed to be valid would also need
a bit of care; eg
would need to turn the ö into something else, I think. [[#h_numbers]]
would be easier *and* safer.
| & * Wellington
More information about the pmwiki-users