escape
[ikiwiki.git] / doc / bugs / Toc_map_and_template_plugins_do_not_play_well_together.mdwn
1 I've got a wiki page that contains :
2
3         [[!toc ]]
4         
5         # header1
6         
7         content1
8                 
9         # header2
10         
11         \[[!template id=bla]]
12
13 And `templates/bla.mdwn` contains :
14
15         # header3
16         
17         content3
18         
19         # header4
20         
21         content4
22
23 If no `\[[!map]]` directive is anywhere in the template, the page is rendered as expected.
24
25 If `\[[!map]]` is used e.g. in content4, the wiki page is rendered with
26 the following elements :
27
28 - an empty toc div
29 - every markdown code before the first `\[[!map]]` directive is not
30   interpreted and rendered as-is : `# header1 content1 # header2
31   content2 #header3 #header4 content4_before_the_map`
32 - the correctly rendered map directive result
33
34 If `\[[!map]]` is used in content3, the wiki page is rendered with
35 the following elements :
36
37 - a TOC containing only the last header (header4)
38 - every markdown code before the first `\[[!map]]` directive is not
39   interpreted and rendered as-is : `# header1 content1 # header2
40   content2 #header3 content3_before_the_map`
41 - content3 (starting at the map), header4 and content4 are all rendered as expected
42
43 Moving the `\[[!toc]]` directive from the page to the template gives the same results.
44
45 Removing the `\[[!toc]]` directive or moving it at the end of the page
46 makes the whole wiki page be rendered as expected.
47
48 Hint : in all cases, the non-interpreted markdown code is copied as-is
49 in the HTML output, without any leading `<p>` or any HTML formatting.