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

Refdocs anchors do not work #13799

Open
bryevdv opened this issue Apr 3, 2024 · 2 comments
Open

Refdocs anchors do not work #13799

bryevdv opened this issue Apr 3, 2024 · 2 comments

Comments

@bryevdv
Copy link
Member

bryevdv commented Apr 3, 2024

AFAICT ref docs anchors are just completely broken at present, e.g navigating to

https://docs.bokeh.org/en/latest/docs/reference/models/tools.html#bokeh.models.TapTool

which is what a docs search for "TapTool" returns, just dumps me at the top of the page rather than scrolling down to the TapTool entry on the page.

There is a larger issue to re-org the ref docs to be one page per class, which would help, but in general anchors are more fine-grained, and should function.

@bryevdv
Copy link
Member Author

bryevdv commented Apr 7, 2024

So according to this doc

Destination anchors in HTML documents may be specified either by the A element (naming it with the name attribute), or by any other element (naming with the id attribute).

it does seem as though the anchor for #bokeh.models.TapTool exists in the page on a dt:

<dt class="sig sig-object py" id="bokeh.models.TapTool">

I got around to checking other browsers and discovered that the anchor only seems to fail in Chrome, but works in Safari.

Perhaps this is just a case of our refdocs pages being too big for some browsers to be happy with?

@bryevdv
Copy link
Member Author

bryevdv commented Apr 7, 2024

Guessing it is a size/loading issue. Navigating to the main tools page and waiting for it to load, then selecting TapTool out of the side menu does actually work. But opening a new tab directly to the anchor URL does not.

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

No branches or pull requests

1 participant