安企CMS模板中如何使用`truncatechars`和`truncatewords`截取文本？

作为一位深谙安企CMS（AnQiCMS）运作的网站运营人员，我深知内容呈现的精妙之处。在构建引人入胜、用户友好的网站体验时，如何优雅地处理文本内容的展示是一个核心环节。安企CMS 凭借其灵活的类 Django 模板引擎，为我们提供了强大的内容控制能力，其中文本截取功能便是我们优化页面布局、提升阅读体验的常用工具。

本文将详细探讨安企CMS模板中用于文本截取的两个核心过滤器：truncatechars 和 truncatewords，并介绍在处理富文本内容时同样重要的 HTML 安全截取方法，以及在实际运营中的应用策略。

理解 truncatechars：按字符精确截取文本

在很多场景下，我们需要精确控制文本的长度，例如在生成网页的元描述、文章卡片摘要或简短提示时。此时，truncatechars 过滤器便能派上用场。

truncatechars 的作用是根据指定的字符数量来截取文本。它会从文本的起始位置开始计数，一旦字符总数达到或超过您设定的阈值，文本就会被截断，并在其末尾自动添加一个省略号（...）。

使用语法与示例：

在安企CMS模板中，使用 truncatechars 的语法非常简洁。您只需将需要截取的变量通过管道符 | 连接到 truncatechars 过滤器，并在其后附上您希望保留的字符数量。

例如，假设我们有一个名为 archive.Description 的变量，其中存储了某篇文章的描述性内容。如果我们需要将其截取为不超过 50 个字符：

{{ archive.Description|truncatechars:50 }}

这段代码会智能地输出 archive.Description 的前 50 个字符。如果原始描述的长度超过 50 个字符，过滤器会在第 50 个字符之后追加一个省略号（...）。

让我们看一个具体例子： 如果 archive.Description 的原始文本是：”安企CMS是一个基于Go语言开发的企业级内容管理系统，致力于提供高效、可定制、易扩展的内容管理解决方案，旨在成为中小企业和内容运营团队的首选工具。”

使用 {{ archive.Description|truncatechars:30 }} 将会输出：”安企CMS是一个基于Go语言开发的企业级内容管理系统，致力于提供高效、可定制…“。在这里，即使中文的一个汉字也算作一个字符进行计数。

理解 truncatewords：按单词智能截取文本

与 truncatechars 关注字符数量不同，truncatewords 过滤器则侧重于按单词数量来截取文本。这对于英文等以空格分隔单词的语言尤为有用，它能确保截取后的文本保持单词的完整性，从而提高可读性。与 truncatechars 类似，如果原始文本的单词数量超出了指定值，它同样会在末尾添加省略号（...）。

使用语法与示例：

truncatewords 的使用语法与 truncatechars 保持一致，唯一的区别在于传递给过滤器的参数代表的是单词的数量：

{{ archive.Description|truncatewords:10 }}

这行代码将输出 archive.Description 的前 10 个单词。如果原始文本的单词总数超过 10 个，过滤器同样会在末尾加上 “…“。

以一个英文描述为例： 如果 archive.Description 的原始文本是：”AnQiCMS is an enterprise-level content management system developed based on Go language, committed to providing efficient, customizable, and extensible content management solutions, aiming to be the first choice for small and medium-sized enterprises and content operation teams.”

使用 {{ archive.Description|truncatewords:15 }} 将会输出：”AnQiCMS is an enterprise-level content management system developed based on Go language, committed to providing efficient, customizable…“。可以看到，它保留了完整的单词。

优化网站内容展示：何时运用文本截取

这两个文本截取过滤器在网站内容运营中扮演着至关重要的角色，它们的主要目标是提升用户体验并确保页面布局的整洁与一致性：

在文章或产品列表页面，展示完整冗长的内容会使页面显得笨重且加载缓慢。通过巧妙截取内容的摘要，我们能够快速吸引用户的注意力，激发他们点击深入了解详情的兴趣。

对于搜索引擎优化（SEO）而言，元描述（Meta Description）的长度控制至关重要。搜索引擎通常会抓取页面内容的摘要作为搜索结果的描述，而通过运用 truncatechars，我们可以确保元描述的长度适中，避免被搜索引擎无情截断，从而优化搜索结果的展示效果。

此外，这些过滤器还能有效提升网站的排版美观度。它们确保了不同长度的文本在页面布局中保持视觉上的统一性，避免了过长文本撑开布局或破坏精心设计的视觉美感。例如，在卡片式布局中，文章标题或简介的固定长度能够让整体视觉效果更显专业与和谐。

在模板开发的初期阶段，我们也可以利用这些过滤器生成模拟数据，从而方便地测试不同长度文本在页面上的实际显示效果，确保最终设计能应对各种内容长度的挑战。

应对富文本挑战：处理包含 HTML 标签的文本

在实际的内容创作中，我们经常会使用富文本编辑器输入内容，这些内容往往包含丰富的 HTML 标签，如段落、链接、图片、加粗等。如果直接对这类包含 HTML 标签的文本使用 truncatechars 或 truncatewords，很可能会破坏原始的 HTML 结构，导致页面显示混乱甚至功能异常。例如，一个未闭合的 <div> 标签或 <a> 标签可能会使整个页面布局错乱。

为了解决这一问题，安企CMS模板引擎提供了专门用于处理 HTML 内容的过滤器：truncatechars_html 和 truncatewords_html。这两个过滤器在执行文本截取的同时，能够智能地识别并保留 HTML 标签的结构完整性，确保在截取后，页面仍然能正确渲染。

truncatechars_html 示例：

{{ archive.Content|truncatechars_html:100|safe }}

truncatewords_html 示例：

{{ archive.Content|truncatewords_html:20|safe }}

需要特别强调的是，当您使用 truncatechars_html 或 truncatewords_html 处理包含 HTML 内容的变量时，通常还需要同时配合使用 `