sphinx-hoverxref: Preview tooltips for cross-references

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™️.