在安企CMS中管理内容时，我们经常会遇到这样的情况：后台编辑框里输入的多行文本，在前端页面显示时却变成了一行，或者换行符被直接显示为文字。这是因为浏览器在渲染HTML时，默认会忽略文本中的单个换行符（\n）。如果希望内容能像在编辑框中那样，保留分段或换行效果，就需要借助AnQiCMS提供的强大模板过滤器，特别是linebreaks和linebreaksbr。

这两个过滤器是AnQiCMS模板引擎中的实用工具，它们的作用是将文本内容中的换行符转换为浏览器能够识别和渲染的HTML标签，从而确保您的多行文本在网站上按预期显示。

linebreaksbr 过滤器：简单换行的首选

linebreaksbr 过滤器，顾名思义，会将文本中的所有换行符（\n）直接替换为HTML的 <br/> 标签。这对于那些需要简单换行而不是进行段落分割的文本非常有用，比如：

  • 地址信息：当您需要在联系页面显示详细地址时，可能希望每行地址元素都能独立显示，而不是挤在一起。
  • 产品特点列表：如果产品描述中包含多个简短特点，希望每个特点独占一行，linebreaksbr 就能派上用场。
  • 诗歌或歌词：这些内容通常要求严格的行对行显示。

使用示例：

假设您的后台文本内容是：

公司名称：AnQiCMS
联系电话：123-4567-8900
公司地址：某某市某某区某某街道123号

在模板中，您可以这样使用 linebreaksbr：

<div class="contact-info">
    <h3>联系方式</h3>
    <p>{{ system.contact_details|linebreaksbr|safe }}</p>
</div>

经过渲染后，浏览器会显示为：

<div class="contact-info">
    <h3>联系方式</h3>
    <p>公司名称：AnQiCMS<br/>联系电话：123-4567-8900<br/>公司地址：某某市某某区某某街道123号</p>
</div>

这样，每条信息都会在页面上单独占据一行。

值得注意的是，在使用这个过滤器时，通常还需要加上 |safe 过滤器。这是因为AnQiCMS（以及许多其他模板引擎）为了安全考虑，默认会对输出的HTML内容进行转义，将 < 转换为 &lt; 等。而 |safe 告诉模板引擎，这部分内容是安全的，不需要进行转义，可以直接按HTML解析。如果缺少 |safe，你的 <br/> 标签可能会以纯文本形式显示，而非实际的换行效果。

linebreaks 过滤器：语义化段落的利器

与 linebreaksbr 相比，linebreaks 过滤器则提供了更具语义化的处理方式，它更侧重于将多行文本转换为结构化的段落。具体来说：

  • 它会将单个换行符转换为 <br/> 标签，就像 linebreaksbr 一样。
  • 但更重要的是，它会将两个或更多连续的换行符（通常在文本编辑器中表示一个新段落的开始）转换为HTML的 <p> 和 </p> 标签包裹的段落。

这种处理方式使得 linebreaks 过滤器非常适合处理较长的文章内容、博客正文或任何需要清晰段落结构的文本。它能够更好地保留你内容的原有结构，并使其在视觉上更具可读性，同时对搜索引擎也更友好，因为它使用了语义化的 <p> 标签。

使用示例：

假设您的后台文章内容是：

这是文章的第一段内容。
它包含一些重要的信息，并且在这里结束。

这是文章的第二段内容。
它与第一段通过空行分隔，理应是独立的段落。

在模板中，您可以这样使用 linebreaks：

<div class="article-content">
    <h2>{{ article.title }}</h2>
    <div class="main-body">
        {{ article.full_content|linebreaks|safe }}
    </div>
</div>

经过渲染后，浏览器会显示为：

<div class="article-content">
    <h2>文章标题</h2>
    <div class="main-body">
        <p>这是文章的第一段内容。<br/>它包含一些重要的信息，并且在这里结束。</p>
        <p>这是文章的第二段内容。<br/>它与第一段通过空行分隔，理应是独立的段落。</p>
    </div>
</div>

这里，内容被正确地分成了两个 <p> 段落，段落内的换行则用 <br/> 表示。同样，|safe 过滤器在这里也是不可或缺的。

如何选择 linebreaks 和 linebreaksbr？

选择哪个过滤器，主要取决于您内容的语义和预期展示效果：

  • 如果您需要的是简单的行内换行，不涉及明确的段落概念，例如地址、短句列表或商品特点等，那么 linebreaksbr 是更轻量且直接的选择。
  • 如果您处理的是长篇文章、新闻内容或其他需要清晰段落结构的长文本，并且您希望保留原始文本中的段落意图，那么 linebreaks 会提供更具语义化的HTML输出，有助于提高内容的可读性和SEO友好度。

它们都是AnQiCMS模板开发中，提升用户体验和内容呈现质量的实用工具。通过灵活运用这两个过滤器，您可以轻松地解决多行文本在网页上显示的问题，让您的内容在AnQiCMS驱动的网站上更美观、更具可读性。

扩展阅读：linenumbers 过滤器

除了处理换行，AnQiCMS还提供了 linenumbers 过滤器，它可以给多行文本的每一行进行标号，符号从1开始，如 “1. “。例如，如果你需要在一个代码块或某种特定文本区域显示带行号的内容，{{ code_block|linenumbers|safe }} 就能派上用场。

常见问题 (FAQ)

  1. Q: 为什么我使用了 linebreaks 或 linebreaksbr 过滤器，但页面上显示的仍然是纯文本的 <br/> 或 <p> 标签，而不是实际的换行或段落？

    • A: 这通常是因为您忘记在过滤器链的最后加上 |safe 过滤器。AnQiCMS为了防止XSS攻击，默认会将所有HTML标签转义为对应的实体字符（例如 < 转为 &lt;）。|safe 过滤器会告诉模板引擎，这部分内容是安全的HTML，可以按原样渲染，无需转义。所以，请确保您的模板代码是 {{ variable|linebreaksbr|safe }} 或 {{ variable|linebreaks|safe }}。

  2. Q: 这两个过滤器会自动处理Markdown语法吗？例如，我后台输入的是Markdown格式的文本，它们能直接转换成HTML吗？

    • A: 不会。linebreaks 和 linebreaksbr 过滤器仅专注于将原生的换行符（\n）转换为HTML的 <br/> 或 <p> 标签。它们不会解析或转换Markdown语法。如果您的内容是Markdown格式，您