X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/a6d999df1c02a14881098c1811c41be3c9dabfb3..d6ff694ff7a6a4700ccbbd5819907eac73cf065a:/doc/todo/OpenSearch.mdwn diff --git a/doc/todo/OpenSearch.mdwn b/doc/todo/OpenSearch.mdwn index 513fa3394..c35da54e1 100644 --- a/doc/todo/OpenSearch.mdwn +++ b/doc/todo/OpenSearch.mdwn @@ -1,6 +1,6 @@ [[plugins/search]] could provide [OpenSearch](http://www.opensearch.org/) metadata. Various software supports OpenSearch (see the Wikipedia article on -[[wikipedia OpenSearch]]); in particular, browsers like Firefox and Iceweasel +[[!wikipedia OpenSearch]]); in particular, browsers like Firefox and Iceweasel will automatically discover an OpenSearch search and offer it in the search box. @@ -14,3 +14,25 @@ information in `ikiwiki.setup`, and the `title` attribute of the `link` should contain the wiki title from `ikiwiki.setup`. --[[JoshTriplett]] + +> I support adding this. I think all that is needed, beyond the simple task +> of adding the link header, is to make the search plugin write out +> the xml file, probably based on a template. +> +> One problem is that the +> [specification](http://www.opensearch.org/Specifications/OpenSearch/1.1#OpenSearch_description_document) +> for the XML file contains a number of silly limits to field lenghs. +> For example, it wants a "ShortName" that identifies the search engine, +> to be 16 characters or less. The Description is limited to 1024, +> the LongName to 48. This limits what existing config settings can be +> reused for those. +> +> Another semi-problem is that the specification saz: +> +>> OpenSearch description documents should include at least one Query element of role="example" that is expected to return search results. Search clients may use this example query to validate that the search engine is working properly. +> +> How should ikiwiki know what example query will return actual results? +> (How would a client know if a HTML page contains results or not, anyway?) +> Sillyness. Ignore this? --[[Joey]] + +[[wishlist]]