在内容管理系统中，有效地展示单个文档的详细信息是核心需求之一。无论是新闻文章、产品介绍还是服务说明，用户总是希望能够直观、全面地了解每个项目的具体内容。安企CMS（AnQiCMS）为此提供了强大的 archiveDetail 标签，让您能够轻松地获取并显示单个文档的所有信息，甚至包括您自定义的专属字段。
获取文档核心信息：archiveDetail 的基本用法
archiveDetail 标签是安企CMS模板中用于精确提取单个文档详细数据的工具。它的基本语法是 {% archiveDetail 变量名称 with name="字段名称" id="文档ID" %}。这里，变量名称 是一个可选的别名，用于在后续模板代码中引用获取到的数据；name 参数指定您想要获取的具体文档字段；而 id 参数则让您可以指定获取某个特定 ID 的文档。当然，如果您正在文档详情页（例如 detail.html 或 archive/detail.html）中，通常不需要提供 id 参数，系统会默认获取当前页面的文档信息。此外，您也可以通过 token 参数来指定文档的 URL 别名以获取其详情。
这个标签能够帮您提取文档的多种内置字段，例如：
Id: 文档的唯一标识符。Title: 文档的标题。Link: 文档的访问链接。Description: 文档的简短描述或摘要。Views: 文档的浏览量。Logo: 文档的封面主图。Thumb: 文档的封面缩略图。CategoryId: 文档所属分类的ID。
例如，要在详情页显示文档标题，您可以这样写：
<h1>{% archiveDetail with name="Title" %}</h1>
如果您需要获取指定 ID 文档的链接，可以这样：
<a href="{% archiveDetail with name="Link" id="10" %}">查看文档10</a>
特别值得一提的是 Content 字段。它承载着文档的主体内容，通常包含丰富的图文信息甚至 HTML 格式。当您需要展示这些内容时，请务必使用 |safe 过滤器，以确保 HTML 代码能够被正确解析，而不是作为纯文本显示：
<div>{% archiveDetail content with name="Content" %}{{content|safe}}</div>
如果您的内容是 Markdown 格式，并且希望它在前端渲染成 HTML，可以在 Content 字段的 archiveDetail 标签中添加 render=true 参数：
<div>{% archiveDetail content with name="Content" render=true %}{{content|safe}}</div>
另外，对于图片较多的内容，您还可以利用 lazy 参数指定图片懒加载的属性，例如 lazy="data-src"，以便您的前端懒加载脚本能够正常工作。
对于日期时间字段，如 CreatedTime（创建时间）和 UpdatedTime（更新时间），archiveDetail 标签也提供了便捷的 format 参数来直接格式化输出，省去了手动使用 stampToDate 标签的步骤：
<span>发布日期：{% archiveDetail with name="CreatedTime" format="2006年01月02日" %}</span>
拓展用法：自定义字段的灵活展示
安企CMS的强大之处在于其灵活的内容模型设计，允许您根据业务需求自定义文档字段。这些自定义字段也能通过 archiveDetail 标签轻松获取和展示。
假设您在内容模型中为产品定义了一个名为 price 的自定义字段。您可以直接通过 name 参数获取它的值：
<span>产品价格：{% archiveDetail with name="price" %} 元</span>
如果您不确定文档有哪些自定义字段，或者希望动态地展示所有自定义字段，archiveParams 标签就派上用场了。它允许您遍历文档的所有附加参数。通常情况下，您会希望这些参数按照后台的设置顺序显示，这时可以利用 sorted=true 参数（这也是默认行为）：
{% archiveParams params %}
<ul class="custom-fields">
{% for item in params %}
<li>
<strong>{{item.Name}}：</strong>
<span>{{item.Value}}</span>
</li>
{% endfor %}
</ul>
{% endarchiveParams %}
通过这种方式，您可以构建一个通用模板，自动适应不同内容模型下的自定义字段展示。
实际场景应用：文章与产品详情页的构建
将上述标签组合起来，您可以轻松构建出功能完善的文档详情页面。
文章详情页示例： 在一个典型的文章详情页中，您可能需要显示标题、分类、发布时间、标签和文章内容。
<article>
<h1>{% archiveDetail with name="Title" %}</h1>
<div class="meta-info">
<span>分类：<a href="{% categoryDetail with name='Link' id=archive.CategoryId %}">{% categoryDetail with name='Title' id=archive.CategoryId %}</a></span>
<span>发布于：{% archiveDetail with name="CreatedTime" format="2006-01-02" %}</span>
<span>阅读量：{% archiveDetail with name="Views" %}</span>
<div class="tags">标签：
{% tagList tags with itemId=archive.Id limit="5" %}
{% for tag in tags %}
<a href="{{tag.Link}}">{{tag.Title}}</a>
{% endfor %}
{% endtagList %}
</div>
</div>
<div class="article-content">
{% archiveDetail content with name="Content" render=true %}{{content|safe}}</div>
</article>
产品详情页示例： 对于产品详情页，展示图片、名称、自定义参数（如品牌、型号）和详细描述是常见的布局。
<div class="product-detail">
<div class="product-gallery">
<img src="{% archiveDetail with name='Logo' %}" alt="{% archiveDetail with name='Title' %}" />
{# 如果有自定义的图片组字段 'product_images' #}
{% archiveDetail productImages with name="product_images" %}
<div class="thumbnail-list">
{% for img in productImages %}
<img src="{{img}}" alt="产品图" />
{% endfor %}
</div>
{% endarchiveDetail %}
</div>
<div class="product-info">
<h1>{% archiveDetail with name="Title" %}</h1>
<p class="description">{% archiveDetail with name="Description" %}</p>
<div class="product-params">
{% archiveParams params %}
{% for item in params %}
<p><strong>{{item.Name}}：</strong> {{item.Value}}</p>
{% endfor %}
{% endarchiveParams %}
</div>
<a href="tel:{% contact with name='Cellphone' %}" class="contact-btn">立即咨询：{% contact with name="Cellphone" %}</a>
</div>
<div class="product-full-content">
<h2>产品详情</h2>
{% archiveDetail content with name="Content" render=true %}{{content|safe}}
</div>
</div>
小贴士
在模板开发中，当您确定当前页面上下文已经是一个文档对象时（例如在 detail.html 或 archive/detail.html 中），除了使用 {% archiveDetail with name="字段名称" %} 标签外，您还可以直接通过 {{archive.字段名}} 的方式来获取文档的字段，这通常更为简洁方便。例如，<h1>{{archive.Title}}</h1> 就能直接显示文档标题。
总之，archiveDetail 标签为您提供了灵活、强大的方式来在安企CMS中展示单个文档的详细信息，包括所有自定义字段，