Support glossary / term and sphinxcontrib-bibtex

Author: humitos

docs/conf.py

@@ -50,8 +50,11 @@
     'hoverxref.extension',
     'versionwarning.extension',
     'notfound.extension',
+    'sphinxcontrib.bibtex',
 ]
 
+bibtex_bibfiles = ['refs.bib']
+
 intersphinx_mapping = {
     'readthedocs': ('https://docs.readthedocs.io/en/stable/', None),
     'sphinx': ('https://www.sphinx-doc.org/en/master/', None),
@@ -95,6 +98,7 @@
 hoverxref_auto_ref = True
 hoverxref_roles = [
     'confval',
+    'term',
 ]
 
 hoverxref_role_types = {
@@ -107,6 +111,7 @@
 }
 hoverxref_domains = [
     'py',
+    'cite',
 ]
 hoverxref_sphinxtabs = True
 hoverxref_mathjax = True

docs/configuration.rst

@@ -65,10 +65,6 @@ These settings are global and have effect on both, tooltips and modal dialogues.
 
    Description: List containing the Sphinx Domain's names where ``hoverxref`` has to be applied.
 
-   .. warning::
-
-      Only Python Domain (``py``) is currently supported.
-
    Default: ``[]``
 
    Type: list

docs/refs.bib

@@ -0,0 +1,6 @@
+@Book{1987:nelson,
+  author = {Edward Nelson},
+  title = {Radically Elementary Probability Theory},
+  publisher = {Princeton University Press},
+  year = {1987}
+}

docs/requirements.txt

@@ -6,3 +6,4 @@ sphinx-prompt==1.4.0
 sphinx-version-warning==1.1.2
 sphinx-notfound-page==0.7.1
 sphinx-autobuild==2021.3.14
+sphinxcontrib-bibtex==2.4.1

docs/usage.rst

@@ -113,6 +113,40 @@ To enable ``hoverxref`` on a domain, you need to use the config :confval:`hoverx
 indicating which are the domains you desire.
 
 
+Tooltip on glossary terms
+-------------------------
+
+You can add tooltips to glossary terms:
+
+.. code-block:: rst
+
+   See the :term:`sphinx:environment` definition in the glossary.
+
+That will render to:
+
+See the :term:`sphinx:environment` definition in the glossary.
+
+To enable ``hoverxref`` on glossary terms, you need to add ``'term'`` to :confval:`hoverxref_roles`.
+
+
+Tooltip on sphinxcontrib-bibtex cites
+-------------------------------------
+
+If you want to show a tooltip on `sphinxcontrib-bibtex <https://sphinxcontrib-bibtex.readthedocs.io/en/latest/>`_ cites,
+you just need to enable it in :confval:`hoverxref_domains` by adding ``'cite'`` to that list.
+Example:
+
+.. code-block:: rst
+
+   See :cite:t:`1987:nelson` for an introduction to non-standard analysis.
+   Non-standard analysis is fun :cite:p:`1987:nelson`.
+
+See :cite:t:`1987:nelson` for an introduction to non-standard analysis.
+Non-standard analysis is fun :cite:p:`1987:nelson`.
+
+.. bibliography::
+
+
 Tooltip with content that needs extra rendering steps
 -----------------------------------------------------
 

hoverxref/domains.py

@@ -1,3 +1,5 @@
+import docutils
+
 from sphinx.util import logging
 
 logger = logging.getLogger(__name__)
@@ -138,3 +140,38 @@ def _resolve_numref_xref(self, env, fromdocname, builder, typ, target, node, con
 
         self._inject_hoverxref_data(env, refnode, typ)
         return refnode
+
+
+class HoverXRefBibtexDomainMixin(HoverXRefBaseDomain):
+    """
+    Mixin for ``BibtexDomain`` to save the values after the xref resolution.
+
+    This class add the required ``hoverxref`` and ``modal``/``tooltip`` to tell
+    the frontend to show a modal/tooltip on this element.
+
+    https://github.com/mcmtroffaes/sphinxcontrib-bibtex/blob/2.4.1/src/sphinxcontrib/bibtex/domain.py#L281
+    """
+
+    def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode):
+        textnode = super().resolve_xref(env, fromdocname, builder, typ, target, node, contnode)
+        if textnode is None:
+            return textnode
+
+        if any([
+                self._is_ignored_ref(env, target),
+                not (env.config.hoverxref_auto_ref or typ in self.hoverxref_types)
+        ]):
+            return textnode
+
+        # The structure of the node generated by bibtex is between two
+        # ``#text`` nodes and we need to add the classes into the ``reference``
+        # node to get the ``href=`` attribute from it
+        #
+        # (Pdb++) textnode.children
+        # [<#text: 'Nelson ['>, <reference: <#text: 'Nel87'>>, <#text: ']'>]
+        refnode_index = textnode.first_child_matching_class(docutils.nodes.reference)
+        if refnode_index:
+            refnode = textnode.children[refnode_index]
+            self._inject_hoverxref_data(env, refnode, typ)
+
+        return textnode

hoverxref/extension.py

@@ -12,6 +12,7 @@
 from . import version
 from .domains import (
     HoverXRefBaseDomain,
+    HoverXRefBibtexDomainMixin,
     HoverXRefPythonDomainMixin,
     HoverXRefStandardDomainMixin,
 )
@@ -119,6 +120,17 @@ def setup_domains(app, config):
         )
         app.add_domain(domain, override=True)
 
+    if 'cite' in app.config.hoverxref_domains:
+        domain = types.new_class(
+            'HoverXRefBibtexDomain',
+            (
+                HoverXRefBibtexDomainMixin,
+                app.registry.domains.get('cite'),
+            ),
+            {}
+        )
+        app.add_domain(domain, override=True)
+
 
 def setup_sphinx_tabs(app, config):
     """