如何使用`archiveDetail`标签获取特定文档的详细信息？

作为一位资深的网站运营专家，我深知内容是网站的灵魂，而如何高效、精准地展示这些内容，则是我们日常工作中不可或缺的一环。在安企CMS（AnQiCMS）这样功能强大的内容管理系统中，善用其提供的模板标签，能让我们的内容运营事半功倍。今天，我想和大家深入探讨一下archiveDetail这个标签，它是我们获取特定文档详细信息的核心利器，无论您是内容编辑、前端开发者还是网站管理员，掌握它都将为您的工作带来极大的便利。

archiveDetail标签：精准获取文档详情的核心利器

想象一下，当用户点击网站上的一篇文章或产品详情页时，他们期待看到的是完整、详细且排版精良的信息。而archiveDetail标签，正是AnQiCMS为了实现这一目标而设计的。它的核心作用，是帮助我们在模板中精确地提取并展示单个文档（可以是文章、产品，或其他任何内容模型下的具体条目）的所有相关信息。这意味着，我们不仅可以获取文档的标题、内容、发布时间，甚至可以调取其所属分类、封面图片，以及在后台自定义的任何额外字段，让每一个详情页都充满了生命力。

掌握基本语法：让文档信息随心所欲

archiveDetail标签的使用非常直观，它的基本语法通常呈现为：

{% archiveDetail 变量名称 with name="字段名称" id="文档ID" %}

让我们来逐一解析其中关键的参数：

• 变量名称：这不是必需的，但强烈推荐使用。它允许您将获取到的数据存储在一个自定义变量中，方便在后续模板代码中重复引用，让代码结构更加清晰。如果您选择不定义变量名称，标签会直接输出该字段的值。
• name="字段名称"：这是archiveDetail标签的核心，它指定了您希望获取的具体文档字段。AnQiCMS内置了丰富的字段，例如Title（文档标题）、Content（文档内容）、Link（文档链接）等等，我们稍后会详细介绍一些常用字段。
• id="文档ID" 或 token="文档URL别名"：这两个参数用于精确指定您想要获取的文档。通常在文档详情页，AnQiCMS会自动识别当前页面的文档ID，因此您大多数时候可以省略这两个参数，archiveDetail会智能地获取当前正在访问的文档信息。但当您需要在其他页面（如首页、侧边栏）展示特定文档的详情时，id或token就派上用场了。
• siteId="站点ID"：AnQiCMS支持多站点管理，如果您需要从另一个站点调取文档信息，可以通过此参数指定目标站点的ID。这在构建跨站点内容聚合或展示时非常有用。

常用文档信息字段及其应用实例

archiveDetail标签提供了丰富的字段，让我们能够多维度地展示文档信息。以下是一些在实际运营中我们最常用的字段及其应用场景：

1. 核心信息：标题与链接

• Title (文档标题)：这是文档的灵魂，通常用作页面主标题（H1）。

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

• Link (文档链接)：用于构建文档详情页面的URL，确保用户可以顺利访问。

  
  <a href="{% archiveDetail with name="Link" %}">阅读更多</a>
  

2. 内容展现：富文本与Markdown的智慧处理

• Content (文档内容)：这是文档的主体，通常包含大量的文本、图片和HTML结构。AnQiCMS为Content字段提供了非常灵活的处理方式：
  • |safe 过滤器：由于Content可能包含HTML代码，直接输出可能会被转义。加上|safe过滤器，可以确保HTML内容被正确解析渲染。
  • lazy="data-src" 参数：为了优化页面加载速度，我们可以配合前端懒加载库，通过此参数将<img>标签的src属性转换为data-src或其他自定义属性。
  • render=true/false 参数：如果您的内容是Markdown格式（后台启用了Markdown编辑器），render=true会自动将其渲染为HTML。反之，render=false则不进行渲染。

  {# 结合safe和图片懒加载 #}
  <div class="article-content">
      {% archiveDetail articleContent with name="Content" lazy="data-src" %}
      {{ articleContent|safe }}
  </div>
  
  {# 渲染Markdown内容 #}
  <div class="markdown-body">
      {% archiveDetail articleContent with name="Content" render=true %}
      {{ articleContent|safe }}
  </div>
  

3. 视觉元素：图片资源与展示

• Logo (封面首图)、Thumb (缩略图)、Images (组图)：这些字段用于展示文档的视觉元素，为页面增添吸引力。

  
  {# 展示封面首图 #}
  <img src="{% archiveDetail with name="Logo" %}" alt="{% archiveDetail with name="Title" %}" />
  
  {# 展示组图（Images是一个数组，需要循环） #}
  <div class="gallery">
      {% archiveDetail archiveImages with name="Images" %}
      {% for imgUrl in archiveImages %}
          <img src="{{ imgUrl }}" alt="图片描述" />
      {% endfor %}
  </div>
  

4. 元数据与时间：细节丰富内容

• Description (文档描述)、Keywords (关键词)、Views (浏览量)：这些是SEO和用户洞察的关键信息。

  
  <meta name="description" content="{% archiveDetail with name="Description" %}">
  <span>浏览量：{% archiveDetail with name="Views" %}</span>
  

• CreatedTime (创建时间)、UpdatedTime (更新时间)：时间戳形式的数据需要通过stampToDate函数进行格式化，以人类可读的方式展现。

  
  <span>发布于：{{ stampToDate(archive.CreatedTime, "2006年01月02日 15:04") }}</span>
  

5. 归属信息：分类与模型