是否可以增加狮身人面像搜索页面的深度？

Question

上图是Sphinx文档生成器的搜索功能。

正如您在图片中看到的那样，搜索页面不会显示“＆＃39;”对象＆＃39;在Definitions和Orders下。是否存在使搜索结果更深一层的设置？

Answer 1

我假设您使用objects时引用了文章的一小段文字，其中包含搜索匹配（example）。我们称之为搜索摘要。

1）Sphinx搜索返回的摘要文本的长度是硬编码的，您可以在source code（函数：makeSearchSummary，l.457ff）中看到。 它的典型长度为240个字符（加上两次... = 246）。 要更改此设置，您可以使用自定义搜索功能create your own Sphinx theme。

2）您可能没有看到任何搜索摘要，因为您在文件系统上本地打开搜索。在这种情况下，搜索试图动态地请求搜索命中文件。某些浏览器（即Google Chrome）将这些请求视为非法cross origin requests并阻止它们。在Firefox或Internet Explorer中打开搜索，或尝试使用（本地）静态文件服务器提供文件 - 例如使用sphinx-autobuild。现在，应显示搜索摘要。

3）有know issues个Sphinx搜索摘要。还有一个Sphinx extension trying to fix this（免责声明：我写了扩展名）。