如何在搜索结果页显示匹配关键词的文档列表？
当访客来到您的网站，希望快速找到所需信息时，一个高效且精准的站内搜索功能显得尤为重要。安企CMS（AnQiCMS）在设计之初就充分考虑了这一点，为您提供了灵活强大的内容管理和模板机制，让您能够轻松在搜索结果页展示匹配关键词的文档列表。接下来，我们就一起看看具体如何实现这一功能。
了解安企CMS的搜索机制
安企CMS内置了强大的搜索能力，它会自动索引您发布的内容。当用户在网站上提交搜索请求时，系统会根据用户输入的关键词，在文档的标题、关键词、简介甚至正文内容中进行匹配，并返回最相关的文档。所有的这些结果，都将通过一个专门的搜索页面模板进行展示，让您可以完全掌控其呈现方式。
第一步：确保您的内容可被有效搜索
所有高效的搜索都离不开高质量的内容基础。在安企CMS后台发布或编辑文档时，请务必关注以下几个关键信息：
首先是文档标题，这是用户和搜索引擎了解内容主题的第一扇窗。标题应该清晰、准确，并包含核心关键词。
其次是文档简介，它为文档提供了简要概述，也是搜索引擎结果页通常会显示的内容。如果未填写，系统会自动提取文档内容的前150字。
最重要的是文档关键词。在“添加文档”页面，您可以手动输入或从关键词库中选择相关的关键词。建议多个关键词之间使用英文逗号 , 进行分隔，这不仅有助于安企CMS的内部搜索，也更符合搜索引擎的收录习惯，全面提升您的文档在各种搜索场景下的可见性。
第二步：配置您的搜索结果页模板
在安企CMS中，搜索结果的展示逻辑通常由一个专门的模板文件负责，它就是位于您的模板目录下的 search/index.html。这个模板文件是您自定义搜索结果页面布局和样式的核心。您可以通过编辑它来决定搜索框如何呈现，搜索结果列表如何排列，以及每个文档条目将显示哪些信息，比如缩略图、标题、描述等等。
第三步：在模板中使用archiveList标签获取搜索结果
要在 search/index.html 模板中显示匹配关键词的文档，核心是使用安企CMS提供的 archiveList 标签。这个标签非常灵活，可以用于获取各种文档列表，包括我们的搜索结果。
当您将 archiveList 标签的 type 参数设置为 "page" 时，它会智能地识别URL中由搜索表单传递过来的关键词参数（通常是 q），并自动根据这些关键词过滤和展示文档。
以下是一个基本的示例，展示了如何在 search/index.html 中使用 archiveList 标签来循环显示搜索到的文档：
{# 搜索结果页 (search/index.html) #}
<div>
{% archiveList archives with type="page" limit="10" %}
{% for item in archives %}
<li>
<a href="{{item.Link}}">
<h5>{{item.Title}}</h5>
<div>{{item.Description}}</div>
<div>
<span>{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
<span>{{item.Views}} 阅读</span>
</div>
</a>
{% if item.Thumb %}
<a href="{{item.Link}}">
<img alt="{{item.Title}}" src="{{item.Thumb}}">
</a>
{% endif %}
</li>
{% empty %}
<li>
抱歉，没有找到匹配的文档。
</li>
{% endfor %}
{% endarchiveList %}
</div>
在这个代码片段中，archiveList 标签自动从当前URL中获取搜索关键词进行匹配，并将每页显示10条结果。通过 for item in archives 循环，您可以访问每个文档的标题 (item.Title)、链接 (item.Link)、描述 (item.Description) 等信息，并根据您的设计需求进行布局。
第四步：添加一个友好的搜索表单
为了让访客能够方便地输入关键词进行搜索，您需要在网站的显眼位置，比如页头或者内容区域，放置一个搜索表单。这个表单的目标是 action="/search"，并且其文本输入框的 name 属性必须设置为 q。
同时，为了提升用户体验，您还可以利用 {{urlParams.q}} 这个变量，在用户提交搜索后，将其输入的关键词保留在搜索框中。这样，如果用户想修改关键词或进行二次搜索，就不必重新输入了。
这是一个简单的搜索表单示例：
<form method="get" action="/search">
<div>
<input type="text" name="q" placeholder="请输入搜索关键词" value="{{urlParams.q}}">
<button type="submit">搜索</button>
</div>
</form>
第五步：为搜索结果实现分页功能
当搜索结果较多时，分页是提升用户体验的关键。安企CMS的 archiveList 标签在 type="page" 模式下，与 pagination 标签完美配合，可以轻松实现分页效果。
您只需要在 archiveList 标签之后，添加 pagination 标签，并指定您希望显示多少个页码按钮即可。例如，show="5" 表示最多显示5个页码。
{# 假设这是接在archiveList标签之后的分页代码 #}
<div>
{% pagination pages with show="5" %}
{# 首页 #}
<a class="{% if pages.FirstPage.IsCurrent %}active{% endif %}" href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a>
{# 上一页 #}
{% if pages.PrevPage %}
<a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a>
{% endif %}
{# 中间多页 #}
{% for item in pages.Pages %}
<a class="{% if item.IsCurrent %}active{% endif %}" href="{{item.Link}}">{{item.Name}}</a>
{% endfor %}
{# 下一页 #}
{% if pages.NextPage %}
<a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a>
{% endif %}
{# 尾页 #}
<a class="{% if pages.LastPage.IsCurrent %}active{% endif %}" href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a>
{% endpagination %}
</div>
通过 pages 对象，您可以灵活地构建“首页”、“上一页”、“下一页”以及中间页码的导航，并根据当前页状态添加相应的样式。
小结
通过以上几个简单步骤，您就可以在安企CMS网站上构建一个功能完善、用户友好的搜索结果页面了。从内容发布时的关键词填充，到搜索页模板的精细设计，再到利用 archiveList 和 pagination 标签动态展示结果，安企CMS都提供了直观且强大的工具来帮助您达成目标，让您的网站内容更容易被访客发现和利用。
常见问题 (FAQ)
1. 为什么我的搜索结果有时不准确，或者搜不到某些文档？ 搜索结果的准确性与您发布的内容质量和关键词设置密切相关。请检查文档的标题、简介和关键词是否精准且相关。如果文档内容较少，也可能影响搜索匹配度。另外，请确保在文档发布时，相关内容已被系统正确索引。如果您怀疑是索引问题，可以尝试修改文档后更新缓存，让系统重新处理。
2. 搜索结果页的URL结构可以自定义吗？
是的，安企CMS支持灵活的伪静态规则配置。您可以通过后台的“功能管理”找到“伪静态规则”设置，选择或自定义搜索页面的URL结构。例如，您可以将其设置为 /search?q=关键词 或其他更友好的形式。自定义规则需要谨慎操作，确保不会与其他页面规则冲突。
3. 搜索结果页的布局和样式如何调整？
搜索结果页的布局和样式完全由您的 search/index.html 模板文件以及关联的CSS和JavaScript文件控制。您可以像修改其他页面模板一样，在 search/index.html 中自由添加HTML结构、引入自定义CSS样式，甚至编写JavaScript代码来实现更丰富的交互效果。安企CMS的模板系统基于Django模板引擎语法，提供了高度的