# Welcome to sphinx-hoverxref!¶

sphinx-hoverxref is a Sphinx extension to show a floating window (tooltips or modal dialogues) on the cross references of the documentation embedding the content of the linked section on them. With sphinx-hoverxref, you don’t need to click a link to see what’s in there.

## Usage¶

To show a floating window, use the role hoverxref to link to any document or section and embed its content into it. We currently support two different types of floating windows: Tooltip and Modal.

Writing this reStructuredText in your document:

This will :hoverxref:show a floating window <hoverxref:hoverxref> in the linked words.


it will be rendered to:

This will in the linked words.

Note

The default style (tooltip or modal) is defined by the config .

Tip

These new roles are alias of the ref role and works in the same. See Usage for more detailed information about this and other examples.

## Reference¶

Online documentation: