search-results-example

Search Results - Examples

This page captures common patterns in the return of search results.

The Problem

Many web sites, particularly search engines, return a partial "window" in a much larger dataset of results. We'd like to figure out the optimal way to represent that. Note that this is also the goal of the OpenSearch Response specification, but at this point they don't seem to have specified HTML encodings. In fact, such an encoding is a likely outcome of this effort.

Participants

• Dr. Ernie
• Dimitri Glazkov

Real-World Examples

Links to public web pages, either popular or insightful

OpenSearch

 <opensearch:searchTerms>New York City History</opensearch:searchTerms>
 <opensearch:totalResults>4230000</opensearch:totalResults>
 <opensearch:startIndex>21</opensearch:startIndex>
 <opensearch:itemsPerPage>10</opensearch:itemsPerPage>

rel="alternate" – the same page of search results, in a alternate format

Example: <link rel="alternate" type="text/html" href="http://example.com/New+York+City+History?pw=3&format=html"/>

rel="start" – the first page of search results

Note: This value is pending IETF registration. Example: <link rel="start" type="application/rss+xml" href="http://example.com/New+York+City+History?pw=1&format=rss"/>

rel="previous" – the previous page of search results

Note: This value is pending IETF registration. Example: <link rel="previous" type="application/rss+xml" href="http://example.com/New+York+City+History?pw=2&format=rss"/>

rel="self" – this page of search results

Example: <link rel="self" type="application/rss+xml" href="http://example.com/New+York+City+History?pw=3&format=rss"/>

rel="next" – the next page of search results

Note: This value is pending IETF registration. Example: <link rel="next" type="application/rss+xml" href="http://example.com/New+York+City+History?pw=4&format=rss"/>

rel="end" – the last page of search results

Note: This value is pending IETF registration. Example: <link rel="end" type="application/rss+xml" href="http://example.com/New+York+City+History?pw=42299&format=rss"/>

rel="description" – the location of the OpenSearch Description document

Note: This value is pending IETF registration. Example: <link rel="description" type="application/opensearchdescription+xml" href="http://example.com/opensearchdescription.xml"/>

[Example #2 (url)]

pre
 escaped <tags>

Existing Practices

• Summary of common patterns discovered
• Other attempts to solve The Problem

Proposal

• Early drafts
• Link to related pages as they become available
  • -brainstorming
  • - proposal
  • -microformat

See Also

• forms-examples
• rest-examples
• Other microformats
• Normative references for tags used