在使用AnQiCMS构建网站时，我们经常需要展示包含多行内容的文本，比如文章正文、产品特性描述、代码片段甚至是留言信息。如何让这些多行文本在页面上正确地实现换行，并进一步为某些特定内容（例如代码）添加行号，是提升阅读体验的关键。幸运的是，AnQiCMS强大的模板引擎提供了非常便捷的解决方案，我们可以通过使用内置的过滤器（filters）来轻松实现这些功能。

理解AnQiCMS中的多行文本

在AnQiCMS的后台，当您在内容编辑器中输入多行文本（例如在“发布文档”界面的“文档内容”区域，或在自定义内容模型中创建的“多行文本”字段）并按下回车键时，系统会将其存储为包含换行符（\n）的纯文本。然而，标准的HTML在渲染时，会将多个连续的空格、制表符和换行符视作一个单一的空格。这意味着，如果您直接在模板中输出未经处理的文本，浏览器将不会显示您在后台输入的换行效果。

例如，如果您在后台输入：

这是第一行。
这是第二行。

这是第四行（第三行为空行）。

直接在模板中使用 {{ archive.Content }} 输出，浏览器很可能只会显示成： 这是第一行。 这是第二行。 这是第四行（第三行为空行）。

为了解决这个问题，AnQiCMS提供了专门的过滤器来将文本中的换行符转换为浏览器能够识别的HTML换行标签。

实现文本换行处理

AnQiCMS模板提供了两种常用的过滤器来处理多行文本的换行需求，它们各有侧重，可以根据实际情况灵活选择。

1. 基本换行：使用 linebreaksbr 过滤器

linebreaksbr 过滤器是最直接的换行处理方式。它的作用是将文本中每一个独立的换行符（\n）简单地替换成HTML的 <br/> 标签。这对于那些您只希望实现文本的自然垂直分隔，而不需要形成严格HTML段落结构的场景非常适用，比如一些简短的描述、列表项或地址信息。

使用方法非常直观，您只需要在需要处理的变量后面加上 |linebreaksbr 过滤器即可。同时，由于这个过滤器会生成HTML标签，为了让浏览器正确解析并显示这些标签，您还需要在过滤器链的末尾加上 |safe 过滤器。

{# 假设有一个多行文本变量 `item.Description` #}
<div>
    {{ item.Description | linebreaksbr | safe }}
</div>

{# 如果是文档内容字段，且后台未开启Markdown处理 #}
<article>
    <h1>{{ archive.Title }}</h1>
    <div>
        {{ archive.Content | linebreaksbr | safe }}
    </div>
</article>

经过这样的处理，您后台输入的每一行文本都将在前端页面上独立显示，实现清晰的换行效果。

2. 段落式换行：使用 linebreaks 过滤器

如果您的需求更倾向于结构化的段落显示，linebreaks 过滤器会是更好的选择。它不仅会将单个换行符替换为 <br/> 标签，还会将连续的两个或多个换行符（通常代表一个空行）替换为HTML的 <p> 和 </p> 标签。这有助于将较长的文本内容自动组织成符合HTML语义的段落，对于文章正文、产品详细介绍等需要良好阅读结构的内容尤为合适。

与 linebreaksbr 类似，linebreaks 过滤器也需要与 |safe 过滤器配合使用，以确保生成的HTML标签能够被浏览器正确渲染。

{# 假设有一个多行文本变量 `longText` #}
<section>
    {{ longText | linebreaks | safe }}
</section>

{# 如果是文档内容字段，且后台未开启Markdown处理 #}
<article>
    <h1>{{ archive.Title }}</h1>
    <div class="article-content">
        {{ archive.Content | linebreaks | safe }}
    </div>
</article>

使用 linebreaks 过滤器后，您的多行文本将以更规范的段落形式呈现，提升内容的可读性和页面结构。

实现行号显示

对于需要逐行编号的场景，比如展示代码示例、日志输出或详细步骤列表，AnQiCMS提供了 linenumbers 过滤器。这个过滤器会自动为文本的每一行添加行号前缀，默认格式是 1.、2. 等。

linenumbers 过滤器通常与其他换行过滤器结合使用，以确保行号能够正确地对应到每一行内容。同样，由于它会生成HTML结构（例如 <pre> 和 <code> 标签，以及行号），您依然需要加上 |safe 过滤器来确保浏览器正确解析。

{# 假设有一个代码片段存储在 `archive.CodeSnippet` 自定义字段中 #}
<pre class="code-block">
    <code>{{ archive.CodeSnippet | linenumbers | safe }}</code>
</pre>

{# 也可以结合换行过滤器，确保文本在添加行号前已经有正确的换行结构 #}
<div class="log-output">
    {{ archive.LogContent | linebreaksbr | linenumbers | safe }}
</div>

通过 linenumbers 过滤器，您可以让那些原本是纯文本的多行内容焕发出新的生机，方便读者追踪和引用特定行。

结合实际应用场景的考量

  • 文章内容与Markdown： AnQiCMS支持开启Markdown编辑器来编写文章内容。如果您的内容（如 archive.Content）是通过Markdown编辑器编写的，那么Markdown本身就会处理文本的换行和段落结构，并将其转换为HTML。在这种情况下，直接使用 linebreaks 或 linebreaksbr 过滤器可能不是必需的，甚至可能产生不期望的效果。但是，linenumbers 过滤器仍然可以对Markdown转换后的纯文本内容（即可见的文本行）进行编号，这在某些特殊布局下可能有用。
  • 代码片段： 对于需要在网站上展示代码的情况，我们建议您在内容模型中创建一个专门的“多