在AnQiCMS的模板开发中，我们常常需要对网站上展示的内容进行精炼，比如文章标题、简介，或者一段文本的摘要。如果内容过长，不仅会影响页面的美观，也可能降低用户的阅读体验。AnQiCMS强大的模板引擎提供了简单而高效的方法来解决这一问题，让我们能够轻松地截取字符串，并自动添加省略号（…），从而优雅地限制内容的显示长度。

AnQiCMS的模板系统采用了类似Django模板引擎的语法，它灵活且易于上手。在处理字符串截取时，主要依靠其内置的”过滤器”功能。这些过滤器就像小工具一样，可以对变量的内容进行处理，然后输出处理后的结果。

巧妙利用AnQiCMS的字符串截取过滤器

AnQiCMS为我们提供了四种主要且非常实用的字符串截取过滤器，它们各自应对不同的场景：

  1. truncatechars：按字符数截取（不考虑词的完整性） 这个过滤器会按照你指定的字符数量来截取字符串。需要注意的是，它会将自动添加的省略号（…）也计算在内。如果截取位置恰好在某个词语中间，它也会直接截断。 使用方法： {{ 变量 | truncatechars:长度 }} 示例： 假设 archive.Title 的内容是 “AnQiCMS是一个功能强大的企业级内容管理系统”。 {{ archive.Title|truncatechars:15 }} 输出： AnQiCMS是一个功... 可以看到，”功能”这个词被截断了。

  2. truncatewords：按单词数截取（保持词的完整性） 与truncatechars不同，truncatewords会尝试保持词语的完整性。它会截取你指定数量的单词，并在末尾添加省略号。这个过滤器在处理英文内容时效果非常明显，因为它会识别单词之间的空格。但在处理中文内容时，由于中文没有明显的单词分隔符，其效果可能与truncatechars类似。 使用方法： {{ 变量 | truncatewords:单词数量 }} 示例： 假设 archive.Description 的内容是 “AnQiCMS is a powerful enterprise content management system developed using Go language.” {{ archive.Description|truncatewords:8 }} 输出： AnQiCMS is a powerful enterprise content management system...

  3. truncatechars_html：安全地按字符数截取HTML内容 当我们截取的内容可能包含HTML标签时，直接使用truncatechars可能会导致标签被截断，从而破坏页面的HTML结构，造成显示混乱。truncatechars_html过滤器就能很好地解决这个问题。它会在截取时智能地关闭未闭合的HTML标签，确保截取后的内容依然是有效的HTML。 使用方法： {{ 变量 | truncatechars_html:长度 | safe }} 重要提示： 由于此过滤器处理的是HTML内容，输出时务必加上 |safe 过滤器，以告知模板引擎该内容是安全的，不需要进行转义，从而让HTML标签能够被正确渲染。

  4. truncatewords_html：安全地按单词数截取HTML内容 与truncatechars_html类似，truncatewords_html用于在保持HTML结构完整性的前提下，按单词数截取HTML内容。同样，在输出时也需要配合 |safe 过滤器使用。 使用方法： {{ 变量 | truncatewords_html:单词数量 | safe }}

实际应用中的示例

现在，让我们通过一个实际的场景来展示如何将这些过滤器应用到AnQiCMS的模板中，例如在一个文档列表页中展示文章标题和简介：

假设我们需要在一个循环中展示多篇文章，每篇文章的标题和简介都需要限制长度。

{# 假设我们正在循环一个名为 archives 的文档列表 #}
<ul class="article-list">
    {% for item in archives %}
    <li class="article-item">
        <h3 class="article-title">
            <a href="{{ item.Link }}">
                {# 截取标题，限制为30个字符，并自动添加省略号 #}
                {{ item.Title|truncatechars:30 }}
            </a>
        </h3>
        <div class="article-summary">
            {# 截取简介（假设可能包含少量HTML），限制为100个字符，并安全地处理HTML #}
            {{ item.Description|truncatechars_html:100|safe }}
        </div>
        <a href="{{ item.Link }}" class="read-more">阅读更多</a>
    </li>
    {% empty %}
    <li class="no-content">暂无相关文章。</li>
    {% endfor %}
</ul>

在这个例子中，我们对文章标题使用了truncatechars来确保标题不会过长，同时对简介使用了truncatechars_html和|safe来避免HTML标签被破坏。这样一来，无论原始内容有多长或多复杂，页面都能保持整洁和美观。

通过灵活运用AnQiCMS提供的这些字符串截取过滤器，我们可以轻松实现对页面内容的长度控制，大大提升网站的视觉体验和内容呈现的专业度。

常见问题 (FAQ)

  1. 问：截取后，我不想显示省略号，只想要纯粹的截取，可以实现吗？ 答：AnQiCMS内置的truncatechars和truncatewords系列过滤器设计上是会自动添加省略号的。如果您确实不需要省略号，可以考虑使用slice过滤器进行纯粹的字符串截取。例如：{{ 变量|slice:":30" }}会截取前30个字符而不加省略号。但这需要您自行判断原始字符串长度，并在需要时手动添加省略号。

  2. 问：处理中文内容时，truncatewords过滤器效果不明显，有什么替代方案吗？ 答：truncatewords过滤器主要通过识别英文单词间的空格进行截取。由于中文没有天然的单词分隔符，当直接用于纯中文内容时，它的表现会和truncatechars非常相似，都是按字符数截取。因此，在处理中文内容时，通常推荐直接使用truncatechars或truncatechars_html来按字符数进行截取，这样可以更好地控制显示长度。

  3. 问：为什么在截取HTML内容时，除了truncatechars_html或truncatewords_html，还需要加上|safe过滤器？ 答：AnQiCMS的模板引擎出于安全考虑，默认会对所有输出内容进行HTML转义，以防止XSS攻击。这意味着像<p>、<a>这样的HTML标签会被转义成&lt;p&gt;、&lt;a&gt;，从而显示为纯文本而非实际的HTML结构。当您使用_html系列的过滤器截取了包含HTML的内容后，如果希望这些HTML标签能够被浏览器正确解析和渲染，就需要显式地加上|safe过滤器，告诉模板引擎：“这段内容是经过处理的，是安全的，请不要转义，直接输出HTML。”