作为一名资深的安企CMS网站运营人员，我深知在内容展示方面，如何高效且准确地获取并呈现文档详情数据至关重要。一个精心构建的详情页不仅能满足用户对信息的深入需求，更能通过优化内容结构和用户体验，有效提升网站的粘性与搜索引擎表现。
在安企CMS中，得益于其灵活的Django模板引擎语法，获取和展示文档详情数据是一个直接且强大的过程。核心在于运用专门设计的模板标签，这些标签能够精准地从数据库中提取所需信息，并以结构化的方式呈现在您的网页上。
核心标签：获取文档详情数据
安企CMS模板中用于获取单个文档详情数据的主要标签是 archiveDetail。这个标签是构建任何文章、产品或其他基于内容模型文档详情页面的基石。通过它，您可以访问文档的标题、内容、图片、创建时间、所属分类乃至任何自定义字段。
使用 archiveDetail 标签的基本语法是 {% archiveDetail 变量名称 with name="字段名称" %}。其中，name 参数指定您希望获取的具体文档字段，而 变量名称 则是一个可选的参数，当您需要将获取到的数据存储到一个变量中以便后续更复杂的处理时会用到它。如果不指定变量名称，标签将直接输出字段内容。
通常情况下，在文档详情页模板 ({模型table}/detail.html 或 {模型table}/detail-{文档ID}.html) 中，archiveDetail 标签会默认获取当前正在访问的文档数据，因此无需额外指定文档ID。然而，如果您需要在其他页面（例如首页或列表页）获取某个特定文档的详情，可以通过 id 或 token 参数来明确指定目标文档，如 {% archiveDetail with name="Title" id="1" %} 或 {% archiveDetail with name="Title" token="your-document-alias" %}。对于多站点部署的用户，siteId 参数则允许您跨站点获取数据。
展示文档的基础信息
文档的标题是用户首先关注的元素。您可以使用 {% archiveDetail with name="Title" %} 来展示文档的标题。同样，文档的简介或描述可以通过 {% archiveDetail with name="Description" %} 获取。
文档主体内容是详情页的核心。使用 {% archiveDetail with name="Content" %} 即可输出文档的完整内容。值得注意的是，如果您的内容是通过Markdown编辑器编写的，您可能需要额外使用 render=true 参数来确保Markdown被正确渲染为HTML，例如 {% archiveDetail archiveContent with name="Content" render=true %}{{archiveContent|safe}}。为了防止潜在的XSS攻击，对于包含HTML的内容输出，强烈建议使用 |safe 过滤器。此外，为了优化页面加载速度，对于内容中的图片，您还可以结合 lazy="data-src" 参数来实现图片懒加载。
文档的链接 (Link)、阅读量 (Views)、创建时间 (CreatedTime) 和更新时间 (UpdatedTime) 也是详情页常见的组成部分。例如，{{stampToDate(archive.CreatedTime, "2006-01-02")}} 这样的格式化时间戳标签，能够将时间戳转换为易读的日期格式。文档的封面图片，通常有 Logo (首图) 和 Thumb (缩略图)，如果文档包含多张图片作为轮播或图集，则可以通过 Images 字段获取一个图片URL数组，您可以通过循环遍历这个数组来展示所有图片。
关联数据的深度挖掘
一个文档详情页往往不仅仅包含文档自身的数据，还会关联到其所属的分类、相关的标签以及内容模型中定义的各种自定义参数。
分类信息：通过 archiveDetail 标签获取到的 Category 字段，可以直接访问到分类的ID、标题、链接、描述等信息。例如，{% archiveDetail archiveCategory with name="Category" %}<a href="{{ archiveCategory.Link }}">{{ archiveCategory.Title }}</a> 可以轻松地展示文档所属分类的名称和链接。您也可以单独使用 categoryDetail 标签，通过传递文档的 CategoryId 来获取分类的详细信息。
文档标签：文档标签是内容关联的另一种重要方式。archiveDetail 标签本身不直接输出标签列表，但您可以结合 tagList 标签，通过传递当前文档的ID (itemId=archive.Id) 来获取并展示所有关联的标签。这使得用户可以根据兴趣发现更多相关内容。
自定义参数：安企CMS的内容模型允许您为不同类型的文档定义独特的自定义字段。例如，一个产品模型可能有“价格”、“库存”等字段，而一个文章模型可能有“作者”、“来源”等字段。这些自定义字段可以通过 archiveParams 标签来获取。通过循环遍历 archiveParams 返回的 params 数组，您可以动态地展示所有自定义字段的名称和值，或者通过指定 name="自定义字段名" 来获取某个特定自定义字段的值。例如，{% archiveDetail with name="author" %} 将直接输出名为 author 的自定义字段内容。
实践案例：构建典型的文档详情页
为了更好地理解上述标签的应用，让我们看两个常见的应用场景：
典型文章详情页布局
在一个文章详情页面，您可能会这样组合标签来展示信息：
<article>
<h1>{% archiveDetail with name="Title" %}</h1>
<div class="meta-info">
<a href="{% categoryDetail with name='Link' %}">所属分类：{% categoryDetail with name='Title' %}</a>
<span>发布日期：{% archiveDetail with name="CreatedTime" format="2006年01月02日" %}</span>
<span class="tags">标签：
{% tagList tags with itemId=archive.Id limit="5" %}
{% for item in tags %}
<a href="{{item.Link}}">{{item.Title}}</a>
{% endfor %}
{% endtagList %}
</span>
<span>浏览量：{% archiveDetail with name="Views" %}</span>
</div>
<div class="document-content">
{%- archiveDetail articleContent with name="Content" render=true lazy="data-src" %}
{{articleContent|safe}}
</div>
</article>
典型产品详情页布局
对于产品详情页，除了基本信息，还会重点展示产品图片、参数和联系方式：
<section class="product-detail">
<div class="product-gallery">
{% archiveDetail productImages with name="Images" %}
{% if productImages %}
{% for img in productImages %}
<img src="{{img}}" alt="{% archiveDetail with name='Title' %}" />
{% endfor %}
{% else %}
<img src="{% archiveDetail with name='Logo' %}" alt="{% archiveDetail with name='Title' %}" />
{% endif %}
</div>
<div class="product-info">
<h1>{% archiveDetail with name="Title" %}</h1>
<div class="product-params">
{% archiveParams params %}
{% for item in params %}
<p><span>{{item.Name}}：</span><span>{{item.Value}}</span></p>
{% endfor %}
{% endarchiveParams %}
</div>
<p class="description">{% archiveDetail with name="Description" %}</p>
<div class="contact-info">
联系我们：<a href="tel:{% contact with name='Cellphone' %}" rel="nofollow">{% contact with name="Cellphone" %}</a>
</div>
</div>
<div class="product-content">
<h2>产品详情</h2>
{%- archiveDetail productFullContent with name="Content" render=true %}{{productFullContent|safe}}
</div>
</section>
在上述示例中，我们结合了 archiveDetail、categoryDetail、tagList、archiveParams 和 contact 等多个标签，构建了一个功能完善的文档详情展示页面。通过这种模块化的方式，您可以根据具体业务需求，灵活组合这些标签，创建出独具特色的内容详情页。
常见问答
问题一：如何确保文档内容中的HTML标签或Markdown语法能够正确显示，而不是作为纯文本输出？
当您在内容编辑器中输入了带有HTML标签或Markdown语法的文档内容时，默认情况下，安企CMS为了安全考量，可能会对HTML内容进行转义，导致标签无法渲染。为了确保内容能够正确显示为富文本，您需要在输出 Content 字段时使用 |safe 过滤器。例如，{{ archiveContent|safe }}。如果内容是通过Markdown编辑器输入的，您还需要在 archiveDetail 标签中添加 render=true 参数，以指示系统将Markdown转换为HTML，例如 {% archiveDetail archiveContent with name="Content" render=true %}{{archiveContent|safe}}。
问题二：我如何在文档详情页中展示该文档所属分类的更多信息，比如分类的Logo或描述？
文档详情页默认会加载当前文档的 Category 对象，您可以通过 archiveDetail 标签的 name="Category" 参数获取到这个对象，然后访问其子属性，例如 {% archiveDetail docCategory with name="Category" %}{{ docCategory.Logo }}。此外，您也可以利用 categoryDetail 标签，通过传递当前文档的 CategoryId 来独立获取分类的详细信息，例如，先获取文档的分类ID {% archiveDetail docCatId with name="CategoryId" %}，然后使用 {% categoryDetail with name="Logo" id=docCatId %} 来获取分类Logo。
问题三：我的文档内容模型中添加了自定义字段，如何在文档详情页中展示这些字段？
安企CMS提供了两种主要方式来展示文档的自定义字段。首先，如果您的自定义字段名为 author，您可以在模板中直接使用 {% archiveDetail with name="author" %} 来输出其值。其次，对于需要循环展示所有自定义字段或进行更复杂逻辑处理的场景，您可以使用 archiveParams 标签。这个标签会返回一个包含所有自定义字段名称和值的数组或映射，您可以对其进行循环遍历或按需访问，例如：
{% archiveParams params %}
{% for item in params %}
<div>{{item.Name}}：{{item.Value}}</div>
{% endfor %}