Fix EPUB #116
Fix EPUB #116
Conversation
| '_static/tachyon-example-flamegraph.html', | ||
| '_static/tachyon-example-heatmap.html', |
There was a problem hiding this comment.
We don't need to include the examples for the EPUB build, so exclude them.
| GIL metrics, and hotspot functions. | ||
| :download:`Try the interactive example </_static/tachyon-example-flamegraph.html>`. | ||
|
|
||
| .. only:: html |
There was a problem hiding this comment.
This tells Sphinx to only include this link for the HTML build. So not for EPUB or any other builders like plaintext. We don't do PDF, but others might build that.
Unfortunately, it seems Sphinx only supports this at the top-level, which means the following link isn't indented like the figure text above. And the text is now a separate paragraph rather than part of the figure text.
|
|
||
| .. only:: html | ||
|
|
||
| `Try the interactive example <../_static/tachyon-example-flamegraph.html>`__. |
There was a problem hiding this comment.
If we make this a regular link rather than use the download role, we (1) can see the served HTML file on the docs server and (2) the link shows up in normal text and not monospaced font.
Before:
After:
This should fix the EPUB failures on python#142676.
📚 Documentation preview 📚: https://cpython-previews--116.org.readthedocs.build/