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?
Converting the notebooks to ReST with nbconvert, then using sphinx on the
.rst files gives a pretty decent effect, except that the title levels are
off a little.
I need to look into hosting for the notebooks, maybe on MS Azure. In the
meantime, I prefer the HTML made by Sphinx to the HTML made by nbconvert
directly. It has index and cross refs and the code blocks scroll
horizontally which is crucial for wide Joy traces. And Garamond. God
bless Garamond.
For the Sphinx docs I'm going to edit the notebook ReST files by hand,
diverging from the originals.
Simon Forman