Allow quick search via ?q=... search param

[oliverpool]

Reviving of #107 (requested in #789)

This is a minimal change, so that when the URL contains ?q=search-term:

• the search-box is automatically opened
• the given search-term is automatically searched for

Preview: https://tailwindcss-com-git-fork-oliverpool-master-tailwindlabs.vercel.app/?q=collapse

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
tailwindcss-com	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Sep 11, 2024 1:31pm

[jnns]

This is great. With this feature merged, things like a DuckDuckGo Bang for tailwindcss.com would be possible.

[gyohza]

Hi! #789 also advocates implementing the OpenSearch specs.

Adding the search query is great, but does little benefit if it's a hidden or guess-based feature. Implementing the OpenSearch specs would mean browsers (at least Firefox and Chromium-based browsers) would promptly detect the underlying custom search engine for the website, including its URL, name and icon, among other benefits.

You could reuse the implementation from #107:

• https://github.com/kemp/docs/blob/794285c4ac7d835066167ae5351803c1b14142ba/source/_layouts/master.blade.php#L19
• https://github.com/kemp/docs/blob/794285c4ac7d835066167ae5351803c1b14142ba/source/opensearch.blade.xml

One last suggestion: it would be nice to update the query param once another search has been performed. We'd want the URL to always reflect the current content, and updating the URL explicitly indicates that the custom search feature is available (e.g. I myself perform random searches to see if the URL changes, then just swap the search query with %s and add it to my custom search engines).

What do you think?

It's very annoying having to navigate to the TW docs all the time and manually activating the search modal. Looking forward to this neat little feature!