如何在模板中正确调用并显示文章的标题和内容？
在使用安企CMS（AnQiCMS）构建和管理网站时，文章的标题和内容是核心元素，它们的正确调用和显示直接关系到网站的视觉呈现、用户体验以及搜索引擎优化。理解如何在AnQiCMS模板中高效、准确地处理这些信息，是进行网站内容运营和模板定制的关键。
AnQiCMS的模板系统采用了类似Django模板引擎的语法，这为内容展示提供了极大的灵活性和可定制性。在模板中，您会发现变量通常使用双花括号 {{变量}} 来表示，而控制逻辑（如条件判断、循环等）则使用单花括号和百分号 {% 标签 %} 进行定义。
AnQiCMS 模板基础概览
在AnQiCMS中，所有的模板文件都存放在 /template 目录下，并以 .html 为后缀。当您需要调用文章的标题和内容时，首先要确保您正在编辑的是正确的模板文件，例如文章详情页通常对应 {模型table}/detail.html 或自定义的 detail.html。模板文件统一采用UTF-8编码，以避免出现乱码问题。
调用文章标题
文章标题是内容的“门面”，在列表页和详情页都有其重要的展示位置。
对于 文章详情页，系统通常会根据URL自动加载当前文章的所有数据，您可以直接通过全局变量 archive 来访问文章的各项属性。因此，要显示文章标题，最直接的方式是使用 {{archive.Title}}。
如果您需要更精细的控制，或者在非详情页（例如侧边栏推荐文章）需要获取特定文章的标题，可以使用 archiveDetail 标签。这个标签专门用于获取单篇文章的详细信息。
示例代码：
{# 在文章详情页，直接通过全局变量archive获取标题 #}
<h1>{{archive.Title}}</h1>
{# 或者使用archiveDetail标签获取当前文章标题 #}
<h1>{% archiveDetail with name="Title" %}</h1>
{# 获取ID为1的文章标题 #}
<h2>{% archiveDetail with name="Title" id="1" %}</h2>
在 文章列表页，您会使用 archiveList 标签来循环展示多篇文章。在 for 循环内部，每一篇文章的数据会赋值给您定义的循环变量（例如 item）。此时，您可以通过 {{item.Title}} 来显示每篇文章的标题。
示例代码：
{% archiveList archives with type="page" limit="10" %}
{% for item in archives %}
<article>
<h2><a href="{{item.Link}}">{{item.Title}}</a></h2>
{# ... 其他列表内容 ... #}
</article>
{% endfor %}
{% endarchiveList %}
展示文章内容
文章内容是页面的核心，它包含了您精心撰写的文字、图片、视频等丰富信息。在AnQiCMS模板中，显示文章内容需要一些额外的处理，以确保其正确渲染并具备良好的用户体验。
与标题类似，在 文章详情页，您可以直接通过 {{archive.Content}} 来获取文章的内容。然而，文章内容通常包含HTML标签（如段落、图片、链接等），如果直接输出，这些HTML标签可能会被浏览器当作纯文本显示。为了让浏览器正确解析并渲染这些HTML，您需要使用 |safe 过滤器。
|safe 过滤器：这个过滤器告诉AnQiCMS模板引擎，您输出的内容是“安全的”，不需要进行HTML转义。它对于显示富文本编辑器生成的HTML内容至关重要。
示例代码：
{# 在文章详情页，通过|safe过滤器显示文章内容 #}
<div class="article-content">
{{archive.Content|safe}}
</div>
{# 或者使用archiveDetail标签获取当前文章内容 #}
<div class="article-content">
{% archiveDetail with name="Content" %}|safe}
</div>
Markdown 内容的渲染：如果您的文章内容是通过Markdown编辑器编写的，AnQiCMS提供了 Content 字段的 render 参数来控制是否将其转换为HTML。
示例代码（Markdown内容渲染）：
{# 强制将Markdown内容渲染为HTML #}
<div class="article-content">
{% archiveDetail articleContent with name="Content" render=true %}{{articleContent|safe}}</div>
图片懒加载优化：为了提升页面加载速度和用户体验，您可以为文章内容中的图片启用懒加载。AnQiCMS的 Content 字段支持 lazy 参数，该参数会将 <img> 标签的 src 属性替换为您指定的懒加载属性（例如 data-src）。
示例代码（图片懒加载）：
{# 启用图片懒加载，将src替换为data-src #}
<div class="article-content">
{% archiveDetail articleContent with name="Content" lazy="data-src" %}{{articleContent|safe}}</div>
实际操作中的考量
- 上下文的重要性：在模板开发中，理解当前模板所处的“上下文”至关重要。在文章详情页，
archive变量是自动可用的；而在循环列表（如archiveList）中，您需要使用循环变量（如item）来访问每篇文章的属性。 - 内容安全性：
|safe过滤器功能强大，但务必谨慎使用。它会阻止模板引擎对HTML内容的转义，这意味着如果文章内容包含恶意脚本，这些脚本也可能被执行。因此，请确保您显示的文章内容来源于可信的源。 - 灵活的调用方式：AnQiCMS提供了多种调用方式，例如直接通过
{{变量.属性}}访问，或者使用{% 标签 with name="属性名" %}。这使得您可以根据具体需求和个人偏好，选择最适合的模板编写风格。
通过掌握这些调用技巧，您可以充分利用AnQiCMS的模板系统，灵活地展示网站的文章标题和内容，打造出既美观又高效的网站页面。
常见问题 (FAQ)
Q1：为什么我的文章内容在前端显示的是原始的HTML代码，而不是排版好的内容？
A1： 这通常是因为您没有在显示文章内容的变量后面添加 |safe 过滤器。在AnQiCMS（以及许多其他模板引擎）中，为了防止跨站脚本攻击（XSS），所有从后台获取并输出到前端的HTML内容默认都会被转义，即HTML标签会被显示为纯文本。例如，如果您要显示 {{archive.Content}}，请务必将其修改为 {{archive.Content|safe}}，这样浏览器才能正确解析并渲染其中的HTML标签。
Q2：如何在文章列表页只显示文章标题和一小段内容摘要，而不是全部内容？
A2： 在文章列表页，您可以使用 archiveList 标签来获取文章列表。对于内容摘要，您可以通过 {{item.Description}} 调用文章的简介字段。如果简介为空，或者您想截取文章内容的某一部分作为摘要，可以使用 |truncatechars 或 |truncatewords 过滤器对 {{item.Content}} 进行截取，并配合 |striptags 过滤器移除所有HTML标签，确保摘要是纯文本。例如：{{item.Content|striptags|truncatechars:100}} 会截取前100个字符（包括中文），并移除HTML标签。
Q3：我的文章是用Markdown格式编写的，如何在前端页面中正确地将其渲染为HTML？
A3： 如果您在后台编辑文章时使用了Markdown编辑器，并在前端希望将其内容正确渲染为HTML，可以在 archiveDetail 标签调用 Content 字段时，添加 render=true 参数。例如：{% archiveDetail articleContent with name="Content" render=true %}{{articleContent|safe}}。这样，AnQiCMS会在输出内容之前，自动将Markdown语法转换成标准的HTML格式，并结合 |safe 过滤器确保其正常显示。