💾 Archived View for kennedy.gemi.dev › site-search › about.gmi captured on 2024-03-21 at 15:09:58. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

🎯 About Kennedy Site Search

I wanteded to allow anyone to add a search feature to their capsule, without needing to be a programmer. It turns out to be easier than I expected. This works because Kennedy is indexing all of Geminispace, and it offers a `site:` modifier to return results only for a specific capsule.

Putting these together, People can create a special link they can include in their capsule which looks like this:

=> gemini://kennedy.gemi.dev/site-search/s/[DOMAIN NAME]/

When someone clicks that link, they can submit a search query and get results just for that capsule!

Create Site Search for your capsule

How does it work

The domain name to search is stored inside the structure of the link.
When you click the link, Kennedy extracts the domain name and includes it in the text prompt of a `10` response, so the user's can type their search query.
When the user submits their query, Kennedy again extracts out the domain name and creates a search query. "site:[domain name] [the user's search query]". It then uses a `31` redirect response to send that query to Kennedy's normal search results page, as if that entire query had been submitted by the user.

Inspiration

Back in the mid 2000's, Google offered a "Site Search" feature that allowed anyone to add Search functionality to their website. They did this by embeding some HTML into the page. I wanted to do something similar for Gemini, with the added challenge that gemtext doesn't have the same capabilities as HTML!

Archived: How can I add a Google Search Box to My Web Site?