文档详情页如何通过`archiveDetail`标签显示文章标题、内容、图片等信息？

在安企CMS中管理网站内容，文档详情页无疑是用户获取信息最核心的阵地。如何将每一篇精心撰写的文章，其标题、内容、图片以及各种附加信息，准确而生动地呈现在用户眼前，这就要巧妙运用我们的archiveDetail标签了。这个标签是专门为展示单篇文档详情而设计的，它的灵活运用将帮助您轻松构建出功能丰富、体验流畅的详情页面。

首先，让我们来认识一下archiveDetail标签的核心作用。当您访问一个文档的详情页面时，安企CMS会自动识别当前页面的文档信息。因此，您无需进行额外配置，可以直接通过archive.字段名这种简洁的方式来调用当前文档的各项数据。例如，想要显示文章标题，直接使用{{ archive.Title }}即可；如果需要展示文章内容，{{ archive.Content }}就能派上用场。这种直观的调用方式，让模板开发变得异常轻松。

不过，如果您需要在一个非文档详情页面（比如首页或者某个列表页的侧边栏）展示特定文档的详情，或者需要将获取到的数据赋值给一个新变量以进行更复杂的处理时，archiveDetail标签的完整语法便显得尤为重要了。它的基本使用形式是{% archiveDetail 变量名称 with name="字段名称" id="文档ID" %}。这里的变量名称是可选的，如果您不设置，标签会直接输出字段的值。而id参数则允许您指定一个具体的文档ID来获取其信息，此外，token参数也能帮助您通过文档的URL别名来精确查找。

在构建文档详情页时，文章的标题和主体内容自然是不可或缺的。您可以通过{{ archive.Title }}来显示文章标题，通过{{ archive.Description }}展示文章简介或描述，这些信息通常用于页面的<title>标签、SEO关键词和Meta描述中。文章的核心部分——详细内容，则通过{{ archive.Content }}来调用。这里有一个非常重要的细节需要注意：文章内容往往包含丰富的HTML标签，为了确保这些标签能够被浏览器正确解析并显示，而不是作为纯文本被转义，您务必在{{ archive.Content }}后面加上|safe过滤器，即{{ archive.Content|safe }}。如果您的文章内容是通过Markdown编辑器撰写的，并且希望在前端页面上渲染成HTML，可以在archiveDetail标签中添加render=true参数，例如{% archiveDetail archiveContent with name="Content" render=true %}{{archiveContent|safe}}。

图片在内容展示中扮演着提升视觉吸引力的关键角色。archiveDetail标签提供了多种方式来调用图片。{{ archive.Logo }}通常用于获取文档的主封面图或首图，而{{ archive.Thumb }}则用于获取经过系统处理的缩略图。如果您的文档附带了多张图片，形成一个图集，那么Images字段会返回一个图片URL的数组。这时，您就需要结合for循环来遍历并展示这些图片了，像这样：

{% if archive.Images %}
<div class="article-gallery">
    <h3>更多精彩图片</h3>
    {% for imgUrl in archive.Images %}
        <img src="{{ imgUrl }}" alt="{{ archive.Title }}的配图">
    {% endfor %}
</div>
{% endif %}

除了上述核心信息，安企CMS还允许您为文档添加丰富的元数据和自定义字段。例如，{{ archive.CategoryId }}可以获取文档所属分类的ID，进而通过{{ archive.Category.Title }}获取分类名称，{{ archive.Category.Link }}获取分类链接，方便用户跳转。文章的发布时间{{ archive.CreatedTime }}和更新时间{{ archive.UpdatedTime }}以时间戳形式存储，您可以使用stampToDate函数将其格式化为易于阅读的日期格式，如{{ stampToDate(archive.CreatedTime, "2006年01月02日 15:04") }}。此外，{{ archive.Views }}能够直观地展示文章的浏览量。

对于文档的标签（Tag），虽然archive对象本身不直接包含标签列表，但您可以结合tagList标签来获取当前文档关联的所有标签，然后在for循环中展示它们：

<div class="article-tags">
    <strong>标签：</strong>
    {% tagList tags with itemId=archive.Id limit="10" %}
        {% for tag in tags %}
            <a href="{{ tag.Link }}">{{ tag.Title }}</a>
        {% endfor %}
    {% endtagList %}
</div>

安企CMS的强大之处还在于其灵活的内容模型，允许您为不同类型的文档（如文章、产品）自定义专属字段。这些自定义字段可以直接通过{{ archive.您的自定义字段名 }}的方式调用。例如，如果您为产品模型定义了一个Price字段，直接{{ archive.Price }}即可。如果自定义字段的内容也可能包含HTML，同样需要加上|safe过滤器。如果您不确定有哪些自定义字段，或者希望动态地展示所有自定义字段，可以利用archiveParams标签来遍历它们：

<div class="article-custom-fields">
    <h3>附加信息</h3>
    {% archiveParams params %}
        {% for item in params %}
            <p><strong>{{ item.Name }}：</strong>{{ item.Value|safe }}</p>
        {% endfor %}
    {% endarchiveParams %}
</div>

通过这些标签的组合运用，您便能够构建出既美观又实用的文档详情页，无论是展示一篇深度文章，还是一款特色产品，都能游刃有余。

常见问题 (FAQ)

  1. 问：为什么我使用{{ archive.Content }}调用文章内容时，页面上显示的是带有HTML标签的原始文本，而不是渲染后的效果？
    • 答： 这是因为安企CMS模板引擎出于安全考虑，默认会对所有输出内容进行HTML转义，以防止XSS攻击。如果您的文章内容包含HTML标签，并且希望它们能被浏览器正常解析，请务必在{{ archive.Content }}后面加上|safe过滤器，即{{ archive.Content|safe }}。

2