rustacean-station / rustacean-station.org

Home of the Rustacean Station podcast
https://rustacean-station.org
209 stars 27 forks source link

work around python-markdown bug #176

Closed ericseppanen closed 1 year ago

ericseppanen commented 1 year ago

Certain patterns within links get eaten by older versions of the python-markdown parser. If you look at the page for this episode, this text and its link are currently missing.

This bug can be worked around by adding an   to the end of the list item. I've encountered this same bug a few times in the TWiR repository, and this is the least ugly workaround I've come up with so far. :shrug:

It can also be fixed for good by upgrading the python-markdown package to 3.3.7 or newer. If you can, I recommend doing that instead, because there are probably more of these hiding out.

jonhoo commented 1 year ago

I'm confused — we don't use Python-Markdown for anything as far as I'm aware? The whole site is just generated with Jekyll, which is all Ruby. It is true that GitHub Pages' default Jekyll is pretty old (https://github.com/github/pages-gem/issues/651), so maybe that's the culprit?

ericseppanen commented 1 year ago

Sorry if I jumped to conclusions. I assumed "same markdown parsing glitch, must be python-markdown" but I suppose it's possible that the same behavior exists in Kramdown too? I'll see if I can learn more.

ericseppanen commented 1 year ago

I can see using babelmark that Kramdown does indeed mis-parse this input.

My workaround appears to be unsuccessful though. I'll need to go hunting for another one.