doc/bugs/discount_stopped_rendering_markdown_links.mdwn

   1 # What I did
   2
   3 Upgraded from 3.20180105 to 3.20180228 (from pkgsrc).
   4 No change to installed Text::Markdown::Discount (0.11nb4 from pkgsrc, using upstream's bundled Discount library).
   5
   6 # What I expected to happen
   7
   8 Markdown-style links to continue being rendered as before.
   9
  10 # What actually happened
  11
  12 Markdown-style links stopped being links.
  13 Instead, they render the part in square brackets as ordinary text.
  14
  15 # Proximate cause
  16
  17 In [f46e429](http://source.ikiwiki.branchable.com/?p=source.git;a=commitdiff;h=f46e429d96ead32943cb2670d7686df8c77de361), if I comment out the `MKD_GITHUBTAGS` if block, the problem goes away.
  18
  19 # Further causes and possible solutions
  20
  21 Some guesses:
  22
  23 - Sufficiently old versions of the Discount library may break when passed unrecognized flags, in which case ikiwiki might want to version-check before passing flags
  24 - The version of the Discount library bundled with upstream Text::Markdown::Discount may be extremely old, in which case pkgsrc might want to make it depend instead on an external Discount package