diff --git a/Doc/conf.py b/Doc/conf.py index a4275835059efa..f6efc5ff22a5e1 100644 --- a/Doc/conf.py +++ b/Doc/conf.py @@ -436,7 +436,12 @@ epub_author = 'Python Documentation Authors' epub_publisher = 'Python Software Foundation' -epub_exclude_files = ('index.xhtml', 'download.xhtml') +epub_exclude_files = ( + 'index.xhtml', + 'download.xhtml', + '_static/tachyon-example-flamegraph.html', + '_static/tachyon-example-heatmap.html', +) # index pages are not valid xhtml # https://github.com/sphinx-doc/sphinx/issues/12359 diff --git a/Doc/library/profiling.sampling.rst b/Doc/library/profiling.sampling.rst index 07951e4702ad20..ba6d08eac80cd4 100644 --- a/Doc/library/profiling.sampling.rst +++ b/Doc/library/profiling.sampling.rst @@ -796,7 +796,10 @@ an interactive flame graph visualization:: The flame graph visualization shows call stacks as nested rectangles, with width proportional to time spent. The sidebar displays runtime statistics, GIL metrics, and hotspot functions. - :download:`Try the interactive example `. + +.. only:: html + + `Try the interactive example <../_static/tachyon-example-flamegraph.html>`__. If no output file is specified, the profiler generates a filename based on the process ID (for example, ``flamegraph.12345.html``). @@ -952,7 +955,10 @@ can be expanded to show which bytecode instructions consumed time: Expanding a hot line reveals the bytecode instructions executed, including specialized variants. The panel shows sample counts per instruction and the overall specialization percentage for the line. - :download:`Try the interactive example `. + +.. only:: html + + `Try the interactive example <../_static/tachyon-example-heatmap.html>`__. Heatmaps are especially useful when you know which file contains a performance issue but need to identify the specific lines. Many developers prefer this