在使用安企CMS发布内容时，我们经常会遇到这样的情况：在内容编辑框中输入的文本，如果包含多行信息，但前台页面展示时，这些换行符却‘消失’了，导致文本挤在一起，阅读体验不佳。这通常是因为HTML默认会将文本中的换行符（\n）视为普通空格。不过，安企CMS提供了一套非常便捷的模板过滤器，能够帮助我们轻松解决这个问题，让多行文本在网页上也能保持原有的排版样式。
核心功能：linebreaksbr 过滤器
当我们需要将用户输入的多行文本中的换行符（\n）直接转换为HTML的<br>标签时，linebreaksbr过滤器是我们的首选工具。它的作用非常直接，就是将每一个文本换行都替换成浏览器可以识别的换行标签<br/>。
使用方法非常直观，只需在您需要处理的变量后面加上 |linebreaksbr 即可。例如，如果您有一个变量叫做 archiveContent，它包含了您从后台获取的多行文本内容，那么在模板中您可以这样使用：
{# 假设 archiveContent 是从文档内容中获取的多行文本变量 #}
{{ archiveContent|linebreaksbr|safe }}
请注意，这里除了|linebreaksbr之外，我们还额外添加了一个|safe过滤器。这是非常关键的一步，因为linebreaksbr过滤器会生成HTML标签（<br/>）。为了确保浏览器能够正确解析这些新生成的HTML标签，而不是将它们作为纯文本（例如直接显示<br>）显示在页面上，我们必须使用|safe来告诉模板引擎，这段内容是安全的HTML，可以按原样输出。
通常，我们会在文章详情页、单页面或自定义内容模型中，将用户在后台文本编辑器里输入的多行内容，通过这种方式在前台显示，以保持内容的原始排版。
了解 linebreaks 过滤器：另一个选择
除了linebreaksbr，安企CMS还提供了linebreaks过滤器。这个过滤器功能类似，但它会更进一步，将文本的每段（由连续的非空行组成，通过空行进行分隔）用<p>标签包裹起来，并在段落内的换行处插入<br/>。
如果您希望多行文本以段落的形式呈现，并带有<p>标签带来的默认样式和语义，那么linebreaks会是更合适的选择。例如，它会将：
第一行文本
第二行文本
第三行文本
处理成：
<p>第一行文本<br/>第二行文本</p><p>第三行文本</p>
如果只是单纯地希望每个换行都变成一个<br/>，而不需要额外的<p>标签包裹，那么linebreaksbr更简洁、更符合直接转换换行的需求。
使用linebreaks过滤器的方式也与linebreaksbr类似，同样需要|safe配合：
{{ archiveContent|linebreaks|safe }}
在安企CMS模板中实际应用
这两个过滤器都属于安企CMS模板系统内置的“过滤器”功能，这意味着它们需要在您的模板文件（通常是.html文件，如文章详情页的detail.html）中调用，作用于您从后台获取的任何包含多行文本的变量。
例如，在展示文档详情时，您可能通过archiveDetail标签获取了文章内容：
{# 假设您正在展示一篇文档的详情页，并且文档内容变量名为 articleContent #}
{% archiveDetail articleContent with name="Content" %}
<div class="document-content">
{# 这里应用过滤器，将用户输入的换行符转换为 <br/> 标签 #}
{{ articleContent|linebreaksbr|safe }} {# 或根据需求使用 |linebreaks|safe #}
</div>
{% endarchiveDetail %}
通过灵活运用linebreaksbr或linebreaks过滤器，安企CMS的用户可以轻松地让后台输入的文本内容在前端页面上保持美观、规范的排版，极大地提升了网站内容的展现效果和用户阅读体验。这不仅是技术细节的优化，更是内容运营中不可忽视的重要一环。
常见问题 (FAQ)
1. 为什么我使用了linebreaksbr或linebreaks后，换行符还是没生效，或者页面上直接显示出了<br>标签的文本？
这个常见问题很可能发生在您在使用这些过滤器后，忘记添加|safe。|safe过滤器是告诉模板引擎，这段内容是安全的HTML，不需要再进行转义。如果缺少了|safe，模板系统出于安全考虑，会将<br>这样的HTML标签转义为<br>，导致页面上直接显示出这些文本而非实际的换行效果。请务必确认您的代码中包含了|safe。
2. linebreaksbr和linebreaks这两种过滤器，我该如何选择？
选择哪种过滤器取决于您希望多行文本在页面上的最终排版效果。
- 如果您只是想让用户输入的每一个换行符都简单地变成一个HTML换行标签（
<br/>），而不额外添加段落标签（<p>），那么linebreaksbr是更简洁、更直接的选择。 - 如果您希望将多行文本自动分割成HTML段落（
<p>标签），并在这些段落内部的换行处添加<br/>，那么linebreaks会是更好的选择，它能为您的内容提供更强的结构化语义。
3. 除了文章内容，还有哪些地方可以用到这些过滤器？
任何从安企CMS后台获取，并且期望保留换行符的多行文本字段都可以使用这些过滤器。这包括但不限于：
- 文章或产品模型的
Description（简介）字段。 - 在自定义内容模型中定义的“多行文本”类型的字段。
- 单页面管理（
pageDetail）中的Content字段。 - 甚至一些留言表单（
guestbook）提交的内容，在显示时如果需要保留用户输入的换行。 总之，只要是用户在后台多行文本框中输入的内容，在前台展示时遇到换行丢失的问题，都可以考虑应用这些过滤器。