What's the difference with `sphinxawesome_theme.docsearch`?

[astrojuanlu]

As per title 😊 We noticed that Awesome Sphinx Theme (amazing theme by the way) has its own DocSearch extension:

https://sphinxawesome.xyz/how-to/configure/#bundled-extensions

https://github.com/kai687/sphinxawesome-theme/blob/dfc68e7ad90eed836fc7b38cb5d52674e104b6df/docs/conf.py#L31

Are there any practical differences?

Context: we want to adopt this (or the other) extension for Kedro https://github.com/kedro-org/kedro/issues/2932

[kai687]

Thanks for your kind words!

The 'bundled' extension that's part of the Awesome Theme cannot be used outside of the Awesome Theme. So, if you want to use the Awesome Sphinx Theme, you don't have to use the sphinx-docsearch extension.

If you want to use another theme, use the sphinx-docsearch extension.

When I wrote the Awesome Sphinx Theme, I baked DocSearch support right into the theme. As I'm working on version 5 of the theme, and having spun-off the sphinx-docsearch extension, I plan to eventually replace the theme's internal DocSearch extension with the sphinx-docsearch extension.

Let me know if that makes sense or not.

[astrojuanlu]

Perfect, thanks for the clarification! Closing this issue

[stichbury]

Thanks @kai687 🙏