Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Content not loading #224

Open
brendan-mcauliffe opened this issue Aug 22, 2022 · 3 comments
Open

Content not loading #224

brendan-mcauliffe opened this issue Aug 22, 2022 · 3 comments

Comments

@brendan-mcauliffe
Copy link

Hi all,

I am trying to get hoverxref to work for the last number of days and to no avail. I am working on some documentation, which is being built and hosted on readthedocs.com.

My issue is that the content is not loading, the window appears and the reference to each section works, but no content gets displayed.

I am using the following command in .rst:
This is implemented in the :hoverxref:`class_of_interest<hoverxref:class_of_interest>` class.

I am using another library, Breathe, to link Doxygen for a C++ based applicaton to RTD. The section of documentation outlining this class is referenced as follows:
.. _hoverxref:class_of_interest:

In my config file I have the following set-up for hoverxref:

extensions = ['sphinxcontrib.seqdiag','sphinxcontrib.blockdiag', 'sphinx_copybutton', 'hoverxref.extension', 'breathe',]

...

hoverxref_auto_ref = True

hoverxref_role_types = {
    'hoverxref' : 'tooltip',
    'ref' : 'tooltip',
}

You will see that I am setting the :ref: command to use hoverxref.

Finally, in my requirements I have the following:

sphinx==4.0.2
sphinx-rtd-theme==1.0.0 
sphinxcontrib-seqdiag==2.0.0
sphinxcontrib-blockdiag==2.0.0
sphinx-autobuild==2021.3.14
docutils==0.17.1
funcparserlib==1.0.0a0
sphinx-toolbox
sphinx-copybutton
sphinx-hoverxref
breathe

Any guidance would be greatly appreciated, this issue is leading to a roadblock in the progression of the document I am writing.

To clarify, I am seeing this issue both when I build and test locally, and when I build and test on the RTD hosted build.

@humitos
Copy link
Member

humitos commented Aug 22, 2022

Hi! Thanks for opening this issue. At first sight, I don't see anything wrong in your configuration. Is your project public? If not, can you create a small public project and host it on Read the Docs for Business (readthedocs.com) where I can reproduce this issue and explore with it (forking the repository if required)?

@brendan-mcauliffe
Copy link
Author

Hi, so I have created a public branch here: https://docs.srsran.com/en/hoverxref_test/general/source/5_devguide_test.html

It seems to be working fine now. Although it seems strange that when I built it on readthedocs.com and viewed the build it did not show any content in the tooltip.

Is there a way to configure this so that I can avoid having to create a live build each time?

@humitos
Copy link
Member

humitos commented Aug 22, 2022

It seems to be working fine now. Although it seems strange that when I built it on readthedocs.com and viewed the build it did not show any content in the tooltip.

Maybe it was a cache issue?

Is there a way to configure this so that I can avoid having to create a live build each time?

This is not currently possible in an easy way. Take a look at #112. BTW, are you using the Pull Request Builder (https://docs.readthedocs.io/en/latest/pull-requests.html)?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants