sphinx-hoverxref: Preview tooltips for cross-references#
Using sphinx-hoverxref, we can preview cross-references in the documentation.
For instance, try placing your mouse over this reference to the front page. We have use a named “target” for the reference. Here are some examples of how to name your targets:
(foobar)=
# My Headline
Here is a paragraph, we link to this headline {hoverxref}`like this <foobar>`.
.. _foobar:
My Headline
===========
Here is a paragraph, we link to this headline :hoverxref:`like this <foobar>`
sphinx-hoverxref works especially well on Read the Docs, since the platform runs the necessary API backend for generating preview data.
Aside from enabling the extention in your project’s _config.yml, you don’t have to do anyhing, it Just Works™️.