aboutsummaryrefslogtreecommitdiff
path: root/doc/bugs/footnotes-look-weird.mdwn
diff options
context:
space:
mode:
authorsmcv <smcv@web>2016-05-04 18:35:33 -0400
committeradmin <admin@branchable.com>2016-05-04 18:35:33 -0400
commite874ce623ba6b367221606cbbae9b11802054747 (patch)
tree2f52ba25a5b823a40e577757c16de3236fc1aa62 /doc/bugs/footnotes-look-weird.mdwn
parentbd881a8ee6dee2f06118596f78c5ac9296a35098 (diff)
downloadikiwiki-e874ce623ba6b367221606cbbae9b11802054747.tar
ikiwiki-e874ce623ba6b367221606cbbae9b11802054747.tar.gz
Diffstat (limited to 'doc/bugs/footnotes-look-weird.mdwn')
-rw-r--r--doc/bugs/footnotes-look-weird.mdwn27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/bugs/footnotes-look-weird.mdwn b/doc/bugs/footnotes-look-weird.mdwn
index 7ea9f240c..d085e9b50 100644
--- a/doc/bugs/footnotes-look-weird.mdwn
+++ b/doc/bugs/footnotes-look-weird.mdwn
@@ -76,6 +76,21 @@ screen readers), as detailed in [this Stack Overflow discussion][].
>> are enabled in their configuration, but I understand that makes the
>> configuration more complicated and error-prone.
>>
+>>> Discount enables enough features by default that adding footnotes doesn't
+>>> seem bad to me. I'm also tempted by something like
+>>>
+>>> ```
+>>> mdwn_enable: [footnotes]
+>>> mdwn_disable: [alphalist, superscript]
+>>> ```
+>>>
+>>> where the default for anything that was neither specifically enabled
+>>> nor specifically disabled would be to enable everything that we don't
+>>> think is a poor fit for the processing model (pandoc-style document
+>>> headers) or likely to trigger by mistake (typographic quotes and
+>>> [[maybe alpha lists|forum/"S."_gets_replace_by_"a."_in_my_ikiwiki]]).
+>>> --[[smcv]]
+>>
>> For example, to enable footnotes, one needs to call Discount like this:
>>
>> Text::Markdown::Discount::markdown($text, Text::Markdown::Discount::MKD_EXTRA_FOOTNOTE())
@@ -90,6 +105,18 @@ screen readers), as detailed in [this Stack Overflow discussion][].
>>
>> In the meantime, wouldn't it be better to have some styling here to
>> workaround the problem in MMD?
+>>
+>>> Honestly, I'd rather have ikiwiki's level of support for the non-preferred
+>>> Markdown implementation be: if you are stuck on a platform with no C compiler
+>>> or Perl headers, you can use the pure-Perl Markdown flavours, and they
+>>> will sort of mostly work (but might not look great).
+>>>
+>>> I'm a little concerned that styling these rather generically-named classes
+>>> might interfere with the implementations of footnotes in other Markdown
+>>> implementations, or indeed non-Markdown - I wouldn't want to style
+>>> `a.footnote` if the HTML produced by some other htmlize hook was
+>>> `<sup><a class="footnote" ...>[1]</a></sup>` for instance.
+>>> But they're probably harmless.
Note that I also make the bottom `<div>` small as well so that it has
less weight than the rest of the text. -- [[anarcat]]