如何在AnQiCMS文章简介中，限制显示的最大单词数量而不是字符数量？

在安企CMS中管理内容时，文章简介（也常被称为摘要）的显示方式对网站的整体美观度和用户体验至关重要。一个好的简介既能吸引读者，又能帮助搜索引擎理解内容。安企CMS默认在文章内容发布时，如果用户没有手动填写简介，系统会自动截取文章内容的前150个字符作为简介。这个机制虽然方便，但在某些情况下，我们可能更希望根据单词数量而非字符数量来控制简介的长度，尤其是在处理多语言内容或希望保持更自然阅读体验的时候。

理解安企CMS默认的简介处理方式

当你在安企CMS后台编辑文章时，会看到一个“文档简介”的字段。如果你在这里手动输入了内容，那么这些内容将作为文章的简介展示。但如果你选择留空，系统便会智能地从文章正文内容中提取，并默认截取前150个“字”来填充。这里的“字”通常指的是字符，对于中文内容而言，一个汉字就是一个字符；对于英文内容，一个字母或符号也算一个字符。

这种基于字符数量的截取方式，在很多情况下都能满足需求。然而，有时它可能导致一些不尽如人意的结果。比如，对于英文内容，150个字符可能包含很多单词，而有时我们只希望简介控制在20个单词左右；反之，对于一些技术性文章，150个字符可能不足以表达核心意思，或者在截取时将一个单词截断，影响阅读连贯性。因此，能够按单词数量来限制简介显示，将大大提升内容呈现的灵活性和专业度。

实现单词数量限制的核心方法：利用模板过滤器

安企CMS提供了强大而灵活的模板机制，允许我们通过修改前端模板文件来精细控制内容的显示方式。虽然后台并没有直接设置“简介显示单词数量”的选项，但我们可以通过利用模板中的过滤器（Filters）来实现这一目标。

在安企CMS的模板系统中，有几个非常实用的过滤器可以帮助我们处理文本截取，其中最适合按单词数量控制简介的是truncatewords和truncatewords_html。

• truncatewords 过滤器：这个过滤器用于截取纯文本内容。它会根据你指定的单词数量进行截取，并在末尾自动添加“…”以示省略。它适用于你的文章简介预期是纯文本，不包含任何HTML标签的情况。
• truncatewords_html 过滤器：如果你的文章简介可能包含HTML标签（例如加粗、链接等），并且你希望在截取后仍然保留这些HTML结构，那么就应该使用truncatewords_html。这个过滤器会在截取文本的同时，尽量保证HTML标签的完整性，避免因截断标签而导致页面显示异常。使用这个过滤器时，通常还需要配合|safe过滤器，告诉模板引擎这段内容是安全的HTML，不需要额外转义。

操作步骤与代码示例

现在，我们来看看如何在实际的模板文件中应用这些过滤器。

第一步：确定要修改的模板文件

文章简介通常会出现在网站的多个位置，比如首页的文章列表、分类页的文章列表、搜索结果页等。你需要根据你的网站布局，找到对应显示文章简介的模板文件。这些文件通常位于你当前使用的模板主题目录下（例如 /template/你的主题名/），文件名可能包括 index.html (首页)、archive/list.html (文章列表页) 或者其他自定义的列表模板。

第二步：定位文章简介的调用位置

在找到的模板文件中，你需要找出用来显示文章简介的代码。通常，这会是一个类似 {{ item.Description }} 或 {{ archive.Description }} 的变量调用。这里的 item 或 archive 代表当前文章对象，而 Description 字段就是文章的简介内容。

第三步：应用 truncatewords 或 truncatewords_html 过滤器

假设你希望文章简介显示20个单词，你可以这样修改代码：

• 如果简介是纯文本，或者你不需要保留其中的HTML标签：

  {# 原始调用，可能显示过长的字符简介 #}
  <p>{{ item.Description }}</p>
  
  {# 修改后：限制显示20个单词 #}
  <p>{{ item.Description|truncatewords:20 }}</p>
  

• 如果简介可能包含HTML标签，并且你希望保留这些标签：

  {# 原始调用，可能显示过长的字符简介 #}
  <div>{{ item.Description|safe }}</div>
  
  {# 修改后：限制显示20个单词，并保留HTML结构 #}
  <div>{{ item.Description|truncatewords_html:20|safe }}</div>
  

  请注意，truncatewords_html过滤器处理后，通常还需要链式使用|safe过滤器，以确保HTML内容被正确解析而不是被转义。

第四步：保存修改并更新缓存

完成模板文件的修改后，请务必保存。然后，登录安企CMS后台，找到“更新缓存”功能，点击清理系统缓存，这样你的修改才能在前台页面生效。接着，访问你的网站前端，检查文章简介是否已经按照单词数量进行了限制显示。

进阶考量与**实践

• 单词数量的选择：选择一个合适的单词数量非常重要。这取决于你的网站设计、文章内容的性质以及你希望传达的信息量。建议多尝试几个数值，找到最能平衡美观与信息传达的那个。
• 手动填写简介的优先级：即使设置了模板过滤器进行单词截取，后台“文档简介”字段手动填写的内容依然拥有最高优先级。如果手动填写的内容已足够精炼，过滤器将不会对其进行二次截取。因此，对于特别重要的文章，手动撰写一个精准的简介仍是**实践。
• 多语言内容的特殊性：truncatewords过滤器主要通过空格来识别“单词”。对于英文等以空格分隔单词的语言，它的效果非常直观。但对于中文、日文等没有空格分隔单词的语言，truncatewords可能会将整段连续的中文文本视为一个“单词”，