在网站内容运营中，文章摘要的呈现方式往往直接影响着读者的点击意愿和阅读体验。一个清晰、简洁且不失原意的摘要，能帮助读者快速了解文章主旨。特别是在列表页、推荐区等场景，我们通常会希望摘要能够智能地截取，既要控制长度，又要保持可读性。

当提到根据文章内容生成摘要时，截取长度是一个核心考量。常见的截取方式有两种：按字符数和按单词数。按字符数截取虽然精确，但常常会遇到单词被生硬截断的情况，影响阅读流畅度。而按单词数截取则能更好地保持语义的完整性，让读者获得的摘要更自然。

对于AnQiCMS的用户来说，系统基于Django模板引擎语法，提供了强大的灵活性，我们可以通过内置的过滤器轻松实现按单词数量截取文章摘要的需求。这个功能主要依赖于 truncatewords 过滤器。

truncatewords 过滤器：按单词智能截取摘要

truncatewords 过滤器专门用于按单词数量截取字符串，它会智能地按照单词边界进行截取，确保每个截取后的词语都是完整的，极大提升了摘要的阅读体验。这与按字符截取（例如truncatechars过滤器）可能导致单词半截不同，truncatewords更注重语义的连贯性。

如何使用 truncatewords 过滤器？

在AnQiCMS的模板文件中，比如您正在编辑一个文章列表页，通过 archiveList 标签获取到文章数据后，通常会遍历 archives 集合中的每个 item 来展示文章信息。文章的简介或摘要一般存储在 item.Description 字段中。

要将 item.Description 截取为指定数量的单词，您只需这样使用：

{{ item.Description|truncatewords:30 }}

在这个例子中，30 表示您希望摘要截取为前30个单词。系统会自动处理截取逻辑，并在内容末尾添加省略号（“…”），让摘要看起来更完整、专业。

处理包含 HTML 标签的内容：truncatewords_html

有时候，您的摘要内容可能不是纯文本，而是直接取自文章正文 item.Content 的一部分，而 item.Content 中可能包含各种HTML标签（如 <strong>、<em>、<p> 等）。如果直接对带有HTML标签的字符串使用 truncatewords，可能会破坏HTML结构，导致页面显示异常。

为了应对这种情况，AnQiCMS提供了另一个非常实用的过滤器：truncatewords_html。这个过滤器与 truncatewords 的功能类似，但它会智能地识别并处理HTML标签，在截取内容的同时保持标签的完整性，避免页面显示错误。

当您需要截取可能含有HTML标签的摘要时，可以这样使用：

{{ item.Content|truncatewords_html:50|safe }}

这里，50 表示截取前50个单词。需要特别注意的是，由于 truncatewords_html 处理后的结果仍然是HTML，为了确保浏览器正确解析并显示这些标签，您需要在过滤器链的末尾加上 |safe。|safe 过滤器会告诉模板引擎，这段内容是安全的，不需要进行自动转义处理，从而让HTML标签得以正常渲染。

小贴士与**实践：

  • 选择合适的单词数量： 摘要的长度并没有固定标准，通常30到50个单词是比较常见的范围。您可以根据网站的整体设计、目标读者以及内容类型，多尝试不同的数值，找到最能吸引读者的平衡点。
  • 预览与调整： 在实际应用 truncatewords 或 truncatewords_html 后，务必在不同设备（PC、手机）上预览效果，确保摘要在各种屏幕尺寸下都能美观、清晰地展示。
  • 与 truncatechars 的区别： 虽然 truncatechars 也能截取文本，但它按字符数计算，可能会将一个单词从中间截断。相比之下，truncatewords 和 truncatewords_html 更注重单词的完整性，在需要保持文本可读性的摘要场景下，是更优的选择。

通过 truncatewords 和 truncatewords_html 这两个灵活且强大的过滤器，AnQiCMS让摘要的生成变得既智能又美观，帮助您更好地呈现内容，吸引读者。

常见问题 (FAQ)

  1. 问：truncatewords 截取后会自动添加省略号吗？可以修改省略号的样式或内容吗？ 答： 是的，truncatewords 和 truncatewords_html 过滤器在截取内容后，默认会自动在末尾添加省略号（“…”）。根据AnQiCMS的文档，这个省略号是系统内置的“可翻译的省略号序列”，目前文档中并未提及直接通过过滤器参数来自定义省略号内容或样式的选项。如果需要非常特殊的省略号展示，可能需要在前端通过CSS或其他JavaScript进行样式覆盖或后期处理。

  2. 问：如果我的文章摘要内容比较短，没有达到 truncatewords 设定的单词数量，它还会添加省略号吗？ 答： 不会。truncatewords 过滤器只会对超出设定单词数量的内容进行截取并添加省略号。如果原始内容（比如 item.Description）的单词数量本身就少于您设定的截取数量（例如 30），那么内容会原样输出，不会添加省略号，以保持内容的完整性。

  3. 问：truncatewords_html 过滤器在处理HTML内容时，会保留所有标签吗？比如像 <div> 这样的块级标签？ 答： truncatewords_html 过滤器在截取过程中会智能地尝试保留HTML结构的完整性，这意味着它会尽可能地闭合标签，避免页面错误。但是，它并非会保留所有标签及其样式。它的主要目的是防止因截取而导致的HTML语法错误，而非完整保留所有原始HTML的渲染效果。对于复杂的HTML结构，建议在后台管理界面直接编辑摘要字段，提供一个干净、精简的HTML片段或纯文本作为摘要，这样前端展示会更可控。