如何在AnQiCMS模板中显示文章的标题和内容？

在AnQiCMS中管理网站内容，最终目的都是为了能够优雅、高效地将这些内容呈现给访问者。对于文章这一最常见的内容类型，如何在前端模板中准确显示其标题和正文，是每个网站运营者都需要掌握的基础技能。AnQiCMS强大的模板功能，为我们提供了灵活直观的实现方式。

核心：认识 archiveDetail 标签

AnQiCMS的模板系统设计得非常人性化，它提供了专门用于获取单篇文章详细数据的archiveDetail标签。当你访问一个文章详情页时，这个标签会智能地识别当前页面的文章，并允许你从中提取所需的各项信息。

它的基本使用形式是这样的：{% archiveDetail 变量名称 with name="字段名称" %}。当然，如果你只是想直接输出某个字段，也可以省略变量名称。例如，{% archiveDetail with name="Title" %}会直接输出当前文章的标题。

如何显示文章标题

文章标题无疑是页面的核心元素，在AnQiCMS模板中显示它非常简单。archiveDetail标签提供了一个名为Title的字段，专门用于获取文章的标题。

在文章详情页的模板（通常是{模型table}/detail.html）中，你可以这样来显示文章标题：

<h1>{% archiveDetail with name="Title" %}</h1>

这行代码会直接把当前文章的标题插入到<h1>标签中。

你可能还会发现，在文章详情页，直接使用{{archive.Title}}也能显示标题。这是因为在文章详情页的上下文环境中，AnQiCMS会自动将当前文章的完整数据封装到一个名为archive的全局变量中。因此，{{archive.Title}}和{% archiveDetail with name="Title" %}都能够达到显示标题的目的。通常，为了简洁和直接访问当前文档的属性，大家更倾向于使用{{archive.Title}}这种形式。

如何显示文章内容

文章内容是页面的主体部分，包含着文章的详细信息、图片、排版等。在AnQiCMS中，内容存储在Content字段里。

要显示文章内容，我们可以使用archiveDetail标签的Content字段：

<div>{% archiveDetail with name="Content" %}</div>

然而，仅仅这样直接输出可能会遇到一个问题：AnQiCMS默认会对模板中输出的所有HTML标签进行转义，以防止潜在的XSS攻击。这意味着如果你在文章内容中使用了加粗、图片、链接等HTML标签，它们会作为纯文本显示，而不是被浏览器解析成应有的样式。

为了让HTML内容正确渲染，我们需要使用一个特殊的过滤器——safe。safe过滤器的作用是告诉模板引擎，这段内容是“安全”的，不需要进行HTML转义，可以直接输出。所以，显示文章内容更推荐的方式是：

<div class="article-content">
    {{ archive.Content|safe }}
</div>

这里我们直接使用了archive全局变量，并通过|safe过滤器确保HTML内容能够正确解析。请务必记住|safe过滤器的重要性，因为它直接影响到文章排版的呈现。

此外，如果你的文章内容是使用Markdown编辑器撰写的，并且希望在前端将其渲染成HTML，可以在archiveDetail标签中添加render=true参数：

<div class="article-content">
    {% archiveDetail articleContent with name="Content" render=true %}{{ articleContent|safe }}
</div>

这样，Markdown语法就会被正确解析为HTML并显示出来。如果你需要对内容中的图片进行懒加载优化，还可以结合lazy="data-src"参数，让模板在输出图片URL时自动替换src属性，以配合前端的懒加载脚本。

综合应用示例

将标题和内容结合起来，通常一个文章详情页的模板片段会包含以下类似的代码结构，同时展示文章的其他基本信息，如发布时间、所属分类和浏览量：

<article class="article-detail">
    <h1 class="article-title">{{ archive.Title }}</h1>
    <div class="article-meta">
        <span class="category">分类：<a href="{{ archive.Category.Link }}">{{ archive.Category.Title }}</a></span>
        <span class="publish-date">发布时间：{{ stampToDate(archive.CreatedTime, "2006-01-02") }}</span>
        <span class="views">阅读量：{{ archive.Views }}</span>
    </div>
    <div class="article-content">
        {{ archive.Content|safe }}
    </div>
</article>

在这个示例中，我们直接使用了archive全局变量来访问文章的各个字段，并通过stampToDate标签将时间戳格式化为可读的日期，archive.Category则是一个对象，可以直接访问分类的链接和标题。这种方式简洁明了，能高效地构建文章详情页。

通过这些灵活的标签和过滤器，AnQiCMS让网站内容的展示变得直观而强大，无论你是要展示简单的文章还是复杂的产品详情，都能游刃有余。

常见问题解答（FAQ）

Q1: 为什么我只写 {{archive.Title}} 也能显示标题，而不是必须用 {% archiveDetail with name="Title" %}？

A1: 在AnQiCMS的文章详情页面，系统会自动将当前文章的全部数据封装到一个名为 archive 的全局变量中。因此，你可以直接通过 {{archive.Title}} 的方式来访问文章标题，这种方式通常更为简洁。{% archiveDetail with name="Title" %} 标签更多用于在非文章详情页（例如首页、列表页）需要根据指定ID或别名获取特定文章信息时使用，或者当你希望通过标签的参数（如render、lazy等）进行更精细控制时。但在文章详情页的上下文，两者都能有效显示标题。

Q2: |safe 过滤器有什么作用？使用它安全吗？

A2: |safe 过滤器是AnQiCMS模板引擎中的一个重要功能，它的作用是告诉模板引擎，被处理的字符串内容是安全的HTML代码，不需要进行默认的HTML实体转义。这意味着，如果你在文章内容中包含了如 <b>、<p>、<img> 等HTML标签，使用 |safe 过滤器后，这些标签会被浏览器正确解析并渲染，而不是以纯文本形式显示。

关于安全性，|safe 过滤器本身不会验证HTML内容的安全性。它只是“信任”你提供的内容是安全的。如果你的文章内容来源于不受信任的用户输入（例如用户在评论区直接输入HTML），并且未经过严格的XSS（跨站脚本攻击）过滤，那么直接使用 |safe 可能会导致安全漏洞。因此，在使用 |safe 之前，请确保你的内容来源可靠，或者内容在保存到数据库之前已经进行了充分的安全过滤。

Q3: 如果我想显示文章的摘要而不是完整内容怎么办？

A3: AnQiCMS在文章管理中提供了一个“文档简介”字段，这通常是用于显示文章摘要的**选择。在模板中，你可以通过 {{archive.Description}} 来获取并显示这个摘要内容。如果“文档简介”字段为空，系统通常会自动从文章内容中提取前150字作为简介。此外，如果你需要更灵活地截取文章内容作为摘要，可以使用模板提供的过滤器，例如 {{archive.Content|truncatewords:50}} 可以截取文章内容的前50个单词作为摘要，并自动在末尾添加省略号。