-
Notifications
You must be signed in to change notification settings - Fork 41
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
Add support for :doc:
role
#18
Comments
+1! I was wondering if this was a misconfiguration on my side, glad that you're tracking it. |
About "too much content", I think sphinx-hoverxref handles this nicely already. See for instance the It's a Maybe a first iteration loading the whole page and then let people complain? :) |
This is correct. I think when I opened this issue the modal (which is a completely different js library) was not implemented yet. Also, we can now make explicit on what roles we want tooltips. So, users can disable on
I tried to do this at the backend level and I failed --but I was doing a lot of things all together at that time (readthedocs/readthedocs.org#8319 (comment)). Maybe we can give it a try again. |
@humitos Is this hard to do? I keep wishing we had it, and I'd love to see a simple implementation if it's not a huge pain. Seems like the main issue is the design decision around how much content to show, and I'm punting for now, and just returning the whole thing. As we said, users can disable this if they want! |
Does the reader benefit from hoverxref when it will end up showing an entire article? I would argue "yes". It's the right place to start 👍
To mature the feature, it would be great to be able to define an excerpt and an "Open Small tweak can also be to see if the work from #227 will help improve page load experience. |
@ericholscher I don't think it should be hard to do the simple version: "Return all the page". I'm adding this issue to the roadmap in Q1, so we prioritize it soon. |
The new implementation will likely change this design, so holding off on this 👍 |
I think it's not hard to implement showing tooltips on
:doc:
. Although, this will retrieve the whole page/document and may be "too much" content to be displayed inside the tooltip.Once the full doc is retrieved, we could cut its content after the first title breaking (
h1
orh2
, for example).The text was updated successfully, but these errors were encountered: