The list of search results always point to the `latest` documentation. Is there a way to handle search queries for multiple versions?

[peytondmurray]

I'm using sphinx-docsearch to provide search results for pydata-sphinx-theme-themed documentation. The documentation is hosted on ReadTheDocs, and we're using RTD to host multiple versions of the documentation.

When I enable sphinx-docsearch, all the results point to the latest version (i.e. https://my-docs.com/en/latest/, even if I'm searching from a different version of the docs. How do I configure sphinx-docsearch to return only results from the version of the docs I'm currently looking at?

For local development replacing the base url with relative URLs instead of the latest docs would be helpful as well.

[kai687]

Hi @peytondmurray,

The issue with versioning is a good one. Need to think about that.

For local development replacing the base url with relative URLs instead of the latest docs would be helpful as well.

Not sure if that's possible since the DocSearch crawler only indexes the published website, and it can't access your local files.

[kai687]

Do you have a sitemap with all your URLs? That would make it fairly straightforward to discover all URLs for all versions.

[peytondmurray]

Sorry for the slow response - I'm told that part of the issue is that the project I'm working on is using the Algolia free tier, meaning that we can only index the latest version. Thanks for the help, though - does it make sense to close this issue, or do you want to keep it open to use it as a space for further versioning discussion?

[kai687]

@peytondmurray I don't think that's necessarily true. Your free tier (depending on the details of that plan) might have a limit on the number of records you can index, but that doesn't mean you can only index the latest version.

I'm keeping this issue open, as I'd still want to tackle this issue eventually.