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

DIsable the version component in RTD #9720

Closed
renardeinside opened this issue Nov 9, 2022 · 9 comments
Closed

DIsable the version component in RTD #9720

renardeinside opened this issue Nov 9, 2022 · 9 comments
Labels
Support Support question

Comments

@renardeinside
Copy link

Details

Expected Result

A description of what you wanted to happen

No version overlay in my project (component with class rst-current-version.

Actual Result

Since some time ago the following version overlay appeared (e.g. here):
Screenshot 2022-11-09 at 12 38 40

I would like to be able to disable it. Project docs are made with mkdocs-material.

@stsewd
Copy link
Member

stsewd commented Nov 9, 2022

Hi! You can change the position of the flyout menu, or hide it using CSS, see https://docs.readthedocs.io/en/stable/flyout-menu.html.

@stsewd stsewd added the Support Support question label Nov 9, 2022
@cbrnr
Copy link

cbrnr commented Dec 5, 2022

@stsewd could you please be more specific on how to hide it? The linked documentation doesn't mention this explicitly.

I would happily leave the flyout menu on my site if it was working – currently, it is rendered but clicking on it has no effect (see https://sleepecg.readthedocs.io/en/stable/).

@humitos
Copy link
Member

humitos commented Dec 7, 2022

@cbrnr

I would happily leave the flyout menu on my site if it was working – currently, it is rendered but clicking on it has no effect (see sleepecg.readthedocs.io/en/stable).

I think it's because the flyout depends on jQuery and you are using Material for MkDocs theme that does not include it. You could manually include jQuery in your project to make it work properly.

We are working on better integration with Material for MkDocs that will solve this problem in the near future.

@cbrnr
Copy link

cbrnr commented Dec 7, 2022

Thank you @humitos! I'm looking forward to a better integration with Material! Meanwhile, if I do not want to include jQuery, can the flyout be disabled or hidden without much hassle?

@chester-leung
Copy link

Hi @humitos , do you have any estimated timeline on the integration with Material for MkDocs? Thank you.

@humitos
Copy link
Member

humitos commented Dec 13, 2022

Hi @chester-leung! The integrations with Material for MkDocs is already in our roadmap, so hopefully it will be done in 2023 Q1.

@cbrnr
Copy link

cbrnr commented Dec 13, 2022

And what about disabling for now?

@chester-leung
Copy link

@cbrnr there is a workaround for this here. I tested this and it seems to work!

@humitos
Copy link
Member

humitos commented Dec 14, 2022

Great! I'm happy that you found a solution to inject jQuery on Material for MkDocs. We are already working on a better integration with Material for MkDocs and we won't be assuming that jQuery is already loaded in the near future. I'm closing this issue, but feel free to open a new one if you find any other problem 👍🏼

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

No branches or pull requests

5 participants