diff options
author | smcv <smcv@web> | 2016-05-04 18:35:33 -0400 |
---|---|---|
committer | admin <admin@branchable.com> | 2016-05-04 18:35:33 -0400 |
commit | e874ce623ba6b367221606cbbae9b11802054747 (patch) | |
tree | 2f52ba25a5b823a40e577757c16de3236fc1aa62 /doc | |
parent | bd881a8ee6dee2f06118596f78c5ac9296a35098 (diff) | |
download | ikiwiki-e874ce623ba6b367221606cbbae9b11802054747.tar ikiwiki-e874ce623ba6b367221606cbbae9b11802054747.tar.gz |
Diffstat (limited to 'doc')
-rw-r--r-- | doc/bugs/footnotes-look-weird.mdwn | 27 |
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]] |