Collective Opensearch collective.opensearch 为生产简单的 OpenSearch 格式的搜索结果添加了功能。
项目描述
项目描述
生成 Open Search Feed
collective.opensearch 为您的 Plone 网站添加了将 OpenSearch 兼容的搜索结果添加到其中的可能性。
全局:这是对 Plone 搜索的一个简单复制,因此您传递给标准 /search 的所有选项都将被识别。
对于集合/主题:您可以在主题内进行搜索,例如,您可以将“基础查询”定义为主题,并应用查询的附加参数。
OpenSearch 是一组用于共享搜索结果的简单格式。
OpenSearch通过引入一组通用的格式,帮助搜索引擎和搜索客户端进行搜索请求和搜索结果同步,从而实现沟通。OpenSearch描述文档格式可以用来描述一个搜索引擎,使其可以被搜索客户端应用程序使用。OpenSearch响应元素可以用来扩展现有的同步格式,如RSS和Atom,并添加返回搜索结果所需的额外元数据。
collective.opensearch允许您通过使用RSS或Atom格式,并增加OpenSearch响应元素来同步您的Plone站点的搜索结果。
实现的扩展和约定
opensearch
相关性
用于自动发现的OpenSearch描述
建议,以便浏览器可以自动完成
响应元素和第一、前一页、下一页、最后一页链接
消费Open Search Feeds
collective.opensearch为您添加了一个视图到链接类型,允许您在您的站点内搜索OpenSearch(或返回RSS或Atom的任何其他搜索,几乎任何其他格式馈送解析器支持的和KML)兼容的搜索提供商。这些馈送不需要实现opensearch扩展,只需它们是有效的馈送即可(例如,您可以查询雅虎、必应、谷歌站点搜索或任何Plone站点)。当您添加一个带有开放搜索URL的链接时,此视图将自动设置。要从您的站点搜索plone.org,请添加一个带有以下URL的链接:http://plone.org/search_rss?SearchableText={searchTerms}
您可以将多个开放搜索链接组合成一个元搜索。当您将文件夹的视图更改为“Open Search View”时,文件夹内的所有OpenSearch链接将被查询,并显示其结果。
用法
1) 单个远程搜索
如果您添加了一个带有兼容OpenSearch描述的URL(即查询字符串中有一个{searchTerms}参数)的链接内容类型,则保存链接时将设置链接视图。
视图由一个简单的搜索表单和查询结果组成
2) 同时搜索多个来源
要构建一个简单的元搜索,请创建一个文件夹并将您的查询链接添加到其中。将文件夹的视图更改为“Open Search View”。该视图由一个搜索表单(目前仅适用于全文搜索)组成,该表单的输入将应用于所有开放搜索链接(即任何将“Open Search View”设置为视图的链接)。搜索结果将显示在表单下方的标签中。查询将通过AJAX异步执行,因此您不需要等待最后一个查询完成。
滥用collective.opensearch以显示杂项馈送
3) 显示任意的“静态”馈送
尽管此产品的重点是生成和显示搜索馈送,但您可以使用它来显示任何有效的馈送。如果您添加的链接的URL不包含{searchTerms}参数且“Open Search View”(您必须从“显示”菜单手动选择视图)被选中为链接的视图,则无论是否存在查询参数,都将获取该馈送,并显示其结果。如果没有{searchTerms}参数,则不会显示搜索表单。
4) 显示多个馈送
将您的源添加到要显示的文件夹中(如[2]所示),并选择“打开搜索视图”作为文件夹“所有源”的显示视图。所有URL中没有包含{searchTerms}参数的源将立即获取,无论是否提供了搜索输入。只有当文件夹内的至少一个链接包含{searchTerms}参数时,搜索表单才会显示。
5) 使用collective.opensearch在您的集合中进行搜索
由于opensearch结果添加到所有集合中,您可以使用它作为搜索表单在您的集合中进行搜索。如果您使用相对链接(例如,/mycollection/SearchableText={searchTerms}),则必须手动选择“打开搜索视图”以显示搜索结果。
已知限制、问题及注意事项
目前只识别和支持全文搜索的{searchTerms}参数
在您的deliverance/xdv/diazo规则中添加‘<match path="regex:^.*/opensearchresults.html*" abort="1" />’
如[5]中所述的内部搜索始终以“匿名”方式执行
在https://github.com/collective/collective.opensearch/issues报告错误
变更日志
1.6 (2017-11-20)
ElementTree修复
1.5 (2014/01/08)
添加JSON结果视图
1.4 (2011/06/17)
与plone 4.1兼容
提示diazo/deliverance不要对ajax响应进行样式化
1.3 (2011/05/19)
支持http://www.eprints.org/结果源(虽然不符合open search规范,但广泛使用)
1.2 (2011/05/18)
在AutoDiscovery视图中捕获所有异常
1.1 (2011/05/11)
在获取远程搜索结果时缓存源
当可用时显示opensearch:totalresults
为网站和主题显示不同的opensearchdescription
为主题添加opensearch视图,在主题内进行搜索
添加用于分类、摘要atom和rss视图条目的索引配置
和条目
1.0 (2011/03/29)
使用ZopeSkel创建了配方
实现从PLOS和JaoP的所有功能
为链接添加opensearch视图
为文件夹添加opensearch视图,该文件夹中的所有opensearch链接都作为元搜索操作
JaoP 0.1(2008年9月23日)
带有默认opensearch属性的第一个Jaop版本
为Firefox / IE添加了默认的自动发现页面(需要一些更改)
实现了rss视图
实现了建议的alpha版本
PLOS 0.2(2007年7月21日)
使Plone能够搜索OpenSearch兼容的搜索提供商
添加了搜索源内容类型
向RSS和ATOM响应添加了内容
PLOS 0.1(2007年5月24日)
初始发布