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

Highlight searchterm in mkdocs #1640

Closed
wants to merge 2 commits into from

Conversation

gregmuellegger
Copy link
Contributor

Sphinx has a theme agnostic feature to highlight terms given by the "highlight" GET parameter. This is used by RTD when linking from the search page to the documentation page.

This did not work for mkdocs projects yet. We add the logic for this to readthedocs-embed-js in order to make this feature available independently of the used mkdocs theme.

This PR is open for discussion. I have a few points in mind that we should discuss:

  • Should that be better part of mkdocs itself?
  • Is the readthedocs-doc-embed.js file the right place to put it? It will increase the filesize just a little with code that is not useful for sphinx builds.

Related #1628

Sphinx has a theme agnostic feature to highlight terms given by the
"highlight" GET parameter. This is used by RTD when linking from the search
page to the documentation page.

This did not work for mkdocs projects yet. We add the logic for this to
readthedocs-embed-js in order to make this feature available independently of
the used mkdocs theme.
@ericholscher
Copy link
Member

This probably belongs in mkdocs, not in our codebase. pinging @d0ugal if ya'll want to steal it.

@stsewd stsewd deleted the highlight-searchterm-in-mkdocs branch September 6, 2018 20:04
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

Successfully merging this pull request may close these issues.

2 participants