From: smcv <smcv@web>
Date: Wed, 4 May 2016 09:48:01 +0000 (-0400)
Subject: discount (as used on this wiki) can do footnotes, but they aren't enabled by ikiwiki
X-Git-Tag: 3.20160506~14
X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/commitdiff_plain/291a09e537ae0eef20dd17b0fe1d3bc0a87b9707

discount (as used on this wiki) can do footnotes, but they aren't enabled by ikiwiki
---

diff --git a/doc/bugs/footnotes-look-weird.mdwn b/doc/bugs/footnotes-look-weird.mdwn
index 3fb8f4bfd..86a132333 100644
--- a/doc/bugs/footnotes-look-weird.mdwn
+++ b/doc/bugs/footnotes-look-weird.mdwn
@@ -48,6 +48,13 @@ screen readers), as detailed in [this Stack Overflow discussion][].
 > If so, please report that as a MultiMarkdown bug, not an ikiwiki bug,
 > or alternatively don't use MultiMarkdown.
 >
+> The recommended backend for the [[plugins/mdwn]] plugin is
+> [[!cpan Text::Markdown::Discount]], which optionally implements
+> footnotes using the same syntax as MultiMarkdown (originating in
+> "PHP Markdown Extra"). However, ikiwiki doesn't currently enable
+> that particular feature. Maybe it should, at least via a site-wide
+> option.
+>
 > What remains after eliminating the MultiMarkdown bug seems to be:
 > ikiwiki's default stylesheet does not contain the necessary styling
 > to work around the non-semantic markup produced by the non-default