aboutsummaryrefslogtreecommitdiff
path: root/doc/bugs
diff options
context:
space:
mode:
authorhttps://id.koumbit.net/anarcat <https://id.koumbit.net/anarcat@web>2016-05-04 09:45:25 -0400
committeradmin <admin@branchable.com>2016-05-04 09:45:25 -0400
commitbd881a8ee6dee2f06118596f78c5ac9296a35098 (patch)
treef90242ec5259fff5f24bb208b2540d95713acce7 /doc/bugs
parent291a09e537ae0eef20dd17b0fe1d3bc0a87b9707 (diff)
downloadikiwiki-bd881a8ee6dee2f06118596f78c5ac9296a35098.tar
ikiwiki-bd881a8ee6dee2f06118596f78c5ac9296a35098.tar.gz
response: confirmation it's a bug in MMD and Discount doesn't have footnotes, and request for workaround
Diffstat (limited to 'doc/bugs')
-rw-r--r--doc/bugs/footnotes-look-weird.mdwn29
1 files changed, 29 insertions, 0 deletions
diff --git a/doc/bugs/footnotes-look-weird.mdwn b/doc/bugs/footnotes-look-weird.mdwn
index 86a132333..7ea9f240c 100644
--- a/doc/bugs/footnotes-look-weird.mdwn
+++ b/doc/bugs/footnotes-look-weird.mdwn
@@ -62,5 +62,34 @@ screen readers), as detailed in [this Stack Overflow discussion][].
> summary?
> --[[smcv]]
+>> That is an accurate summary.
+>>
+>> I didn't realize that Discount didn't actually support footnotes in
+>> Ikiwiki by default. I guess I enabled Multimarkdown exactly for that
+>> kind of stuff that was missing... It seems to me it would be
+>> reasonable to enable footnotes in Ikiwiki. There's already a lot of
+>> stuff that Discount does that is way more exotic (e.g. tables) and
+>> non-standard (e.g. `abbr:`).
+>>
+>> Ideally, users would get to configure which
+>> [Discount flags](http://www.pell.portland.or.us/~orc/Code/markdown/#flags)
+>> are enabled in their configuration, but I understand that makes the
+>> configuration more complicated and error-prone.
+>>
+>> For example, to enable footnotes, one needs to call Discount like this:
+>>
+>> Text::Markdown::Discount::markdown($text, Text::Markdown::Discount::MKD_EXTRA_FOOTNOTE())
+>>
+>> That being said, Discount generates proper semantic markup when
+>> footnotes, so this bug doesn't apply to the default Discount mode,
+>> if we ignore the fact that it doesn't support footnotes at all.
+>> Should I open a todo about this and the above?
+>>
+>> Also, it seems this *is* a bug with multimarkdown - I have
+>> [reported the issue there](https://github.com/bobtfish/text-multimarkdown/issues/30).
+>>
+>> In the meantime, wouldn't it be better to have some styling here to
+>> workaround the problem in MMD?
+
Note that I also make the bottom `<div>` small as well so that it has
less weight than the rest of the text. -- [[anarcat]]