Казахстан, Алматы, Гимназия им. Ахмета Байтурсынова №139, 2008 |
Синдикация и аггрегирование веб-контента. Улучшение usabilty веб-контента.
Синтаксис для шаблона OpenSearch URL
Формат шаблона OpenSearch URL может быть использован для параметризованной формы представления URL в запросе к поисковому сервису.
Поисковый клиент в процессе обработки шаблона попытается заменить каждое вхождение шаблонизированного параметра, представляемого в форме {имя} и значение которого определяется во время выполнения запроса.
По умолчанию, имена параметров рассматриваются как часть пространства имен для шаблонов OpenSearch 1.1, а определения для основных параметров поиска приводятся в спецификации. Однако поисковые службы и поисковые клиенты могут устанавливать новые имена параметров, опираясь на механизм расширяемости в рамках соглашения о префиксах пространств имен XML.
Примеры
Шаблон поискового URL, содержащего шаблонизированный параметр:
http://example.com/search?q={searchTerms}
Шаблон поискового URL, содержащего необязательный шаблонизированный параметр:
http://example.com/feed/{startPage?}
Пример шаблона поискового URL, содержащего необязательный шаблонизированный параметр из расширенного пространства имен в контексте элемента Url:
<Url type="application/rss+xml" xmlns:example="http://example.com/opensearchextensions/1.0/" template="http://example.com?q={searchTerms}&c={example:color?}"/>
Имена параметров могут содержать необязательный префикс, предшествующий локальному имени параметра. И префикс и локальное имя параметра чувствительны к регистру.
Обязательный параметр отличает от необязательно только наличием знака ? после локального имени:
- {searchTerms} - обязательный параметр.
- {startPage?} - необязательный параметр.
Параметры OpenSearch 1.1
Параметр | Назначение и ограничения |
---|---|
searchTerms | Заменяется ключевыми словами из запроса клиента |
count | Заменяется желаемым числом результатов поиска на каждой странице |
startIndex | Заменяется индексом первого поискового результата |
startPage | Заменяется номером страницы для множества поисковых результатов |
language | Заменяется желаемым языком представления результатов поиска для клиента |
inputEncoding | Заменяется значением кодировки, используемой клиентом для формирования своего запроса |
outputEncoding | Заменяется желаемой кодировкой представления результатов поиска для клиента |
Источники
- Библиотека MSDN (http://msdn.microsoft.com/ru-ru/library/default.aspx)
- OpenSearch specification 1.1. (http://www.opensearch.org/Specifications/OpenSearch/1.1)