aboutsummaryrefslogtreecommitdiff
path: root/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn
diff options
context:
space:
mode:
authorJoey Hess <joey@kodama.kitenet.net>2008-07-12 10:40:31 -0400
committerJoey Hess <joey@kodama.kitenet.net>2008-07-12 10:40:31 -0400
commita0f596b6ed4594011b07cf7af2d2d55aa78d8be1 (patch)
treebe282648c8caa67d7e7e3dc624951af54ad383ed /doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn
parent0a09638f968f1b6c82b74ede4caa87461721e7d6 (diff)
downloadikiwiki-a0f596b6ed4594011b07cf7af2d2d55aa78d8be1.tar
ikiwiki-a0f596b6ed4594011b07cf7af2d2d55aa78d8be1.tar.gz
Change deb dependencies to list Text::Markdown before markdown, since the former, while slower, has a much better html parser that avoids numerous bugs.
Diffstat (limited to 'doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn')
-rw-r--r--doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn b/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn
index afeaff60e..608948466 100644
--- a/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn
+++ b/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn
@@ -16,3 +16,15 @@ makes the whole wiki page be rendered as expected.
Hint : in all cases, the non-interpreted markdown code is copied as-is
in the HTML output, without any leading `<p>` or any HTML formatting.
+
+> You're using the old version of `markdown`, that is known to have a broken block
+> html parser, that will get confused if markdown is present between two
+> separate html blocks, and not format the markdown.
+>
+> This is fixed in [[cpan Text::MarkDown]] 1.0.19. markdown 1.0.2 also
+> fixes the problem. Install either one. I'm going to make ikiwiki's
+> dependencies list Text::Markdown before markdown, since people keep
+> stumbling over this. (The downside is that the old broken markdown is
+> faster). --[[Joey]]
+
+[[done]]