The `!-` name doesn't work as a title for the conversion from ReST to
Markdown. Maybe that's a bug in Pandoc, but more likely it's a legit
syntax gotcha in Mearkdown itself.
!-
^^^^
In ReST turns into:
!-\^\^\^\^
In the Markdown. :(
It should be:
# !-
Instead.
I hate filenames, Git hates Bullet • symbol, SNAFU.
I have no idea how to properly escape gnarly filenames. I don't want to
restrict Joy function names (any non-space, non-[] Unicode) so I just
did the quick and dirty thing to make filenames.
I want stub Markdown files for each (as yet undocumented) function.
The functions have docstrings but they are in ReST format. Using the
`wrod.py` script I can fins all the functions that don't yet have doc
files and write their docstrings into a ReST template. Then I use Make
and Pandoc to convert the ReST files to Markdown.
When building the HTML docs with Sphinx v4.3.0 the bullet symbol in
backticks quotes causes this warning message:
.../Joypy/implementations/Python/joy/utils/pretty_print.py:docstring of joy.utils.pretty_print:15: WARNING: Inline interpreted text or phrase reference start-string without end-string.
I hve no idea how this isn't in VCS. I checked hg and git. Is it in
an old branch that I deleted before merging or something? I have
backups from which to restore, but it would be nice to know how I effed
it up in the first place, eh?
https://todo.sr.ht/~sforman/thun-der/15/
The bug file output was too large for a comment, and you can't attach
files to the ticket, so I'm checking it in to have a handy reference.
Simon Forman