287ba5656cfc2a4bc517683970f3e25118f14070
[ikiwiki.git] / doc / plugins / toc / discussion.mdwn
1 If you are using the sidebar plugin and have a header in the sidebar it shows up in the table of contents.  I can see why this happens but it surprised me and wasn't the desired effect in my specific situation. -- [[AdamShand]]
2
3 A related side effect: If you use any sort of headers in the page
4 template (such as placing the page title in an `<h1>`), the toc plugin
5 picks it up.  I suppose it parses the entire page rather than just the
6 rendered content. --[[JasonBlevins]]
7
8 Why doesn't the TOC appear in the edit page preview?  It only appears when the page is finally rendered.  This makes it somewhat difficult to organize headings, saving & re-editing all the time.  My user page currently has a toc to play with: --[[sabr]]
9
10 > Fixed. --[[Joey]]
11
12 Just ran into a side effect of `\[[!toc]]` being a NOP in pages
13 which are inlined: pages with `\[[!template id=note text="\[[!toc]]"]]`
14 wound up having the note rendered in feeds as "Use this template
15 to insert a note into a page". Worked around this by making a local
16 copy of the template and removing its `<TMPL_UNLESS text>...</TMPL_UNLESS>`
17 section. Besides needing to generate guaranteed-unique anchor names,
18 are there other reasons this directive couldn't be made to work on
19 inlined pages?  --[[schmonz]]
20
21 > Workaround: `\[[!template id=note text=" \[[!toc]]"]]`
22 > (with whitespace) should work, because then Perl will consider
23 > the string to be a true value.
24 >
25 > Longer-term, my branch on [[bugs/template_creation_error]]
26 > aims to fix this sort of thing. --[[smcv]]