如何在文章详情页精确控制文档标题、简介、内容等元素的显示？

文章详情页是网站内容的核心展示区域，它直接影响着用户对内容的获取体验和网站的专业度感知。对于AnQiCMS的用户来说，掌握如何精细化控制文章详情页的各个元素显示，不仅能提升网站的视觉效果，更能优化用户阅读路径，有效提升SEO表现。

AnQiCMS作为一个灵活的内容管理系统，提供了多种途径来帮助我们精确调整文章详情页的标题、简介、正文以及其他附加信息的呈现方式。这得益于其强大的模板引擎和后台配置功能。

理解文章详情页的“骨架”：模板文件

在AnQiCMS中，文章详情页的显示离不开模板文件的支持。它就像是内容的“画框”，决定了内容的布局和样式。

首先，每套模板中都有一个默认的文档详情页模板，通常位于 /{模板目录}/{内容模型}/detail.html。例如，如果是文章模型，可能就是 article/detail.html。这个文件定义了该模型下所有文章详情页的通用布局。

其次，如果您希望针对某个特定的文章分类，例如“行业新闻”分类下的文章，采用不同于其他文章分类的布局，AnQiCMS也支持为分类指定独立的模板。您可以在后台编辑分类时，在“其他参数”中设置“分类模板”。例如，设置为 news_list.html，那么只要您的模板目录中存在这个文件，该分类及其子分类的文章就会应用这个模板。

更进一步，安企CMS还支持为单篇文档指定独立的模板。在编辑文章详情时，通过“其他参数”里的“文档模板”字段，您可以为某一篇特别的文章指定一个独特的模板文件，例如 special_report.html。这样，这篇特定的文章就能完全跳脱出通用布局，展现个性化的设计。

灵活运用这些模板文件，是我们精确控制文章详情页显示的第一步。

核心利器：archiveDetail 标签

在模板文件内部，实现文章详情页内容精细化控制的核心标签，无疑是 archiveDetail。这个标签允许我们按需调用文章的各种字段信息。

调用方式通常是 {% archiveDetail 变量名称 with name="字段名称" %}。如果没有定义变量名称，它会直接输出结果；如果定义了变量，比如 {% archiveDetail articleTitle with name="Title" %}，那么就可以通过 {{articleTitle}} 来引用。此外，在文章详情页的上下文中，也可以直接使用 {{archive.文档字段}} 的方式来调用当前文档的字段。

让我们看看如何通过它来控制不同元素的显示：

  • 标题与SEO信息：精准呈现

    • 文档标题 (Title)：这是文章最主要的标题，通常用于页面的 <h1> 标签，直接影响用户阅读和SEO。我们可以通过 {{archive.Title}} 或 {% archiveDetail with name="Title" %} 来显示。
    • SEO标题 (SeoTitle)：如果您希望页面的 <title> 标签内容不同于文章标题，可以在后台设置“SEO标题”。在模板中，可以通过 {% tdk with name="Title" %} 来调用页面的 <title> 内容，它会优先显示文档的SEO标题，然后是文档标题，并可以根据后台设置决定是否附加网站名称后缀。
    • 关键词 (Keywords) 和描述 (Description)：这两项是SEO优化的重要组成部分。它们可以通过 {% tdk with name="Keywords" %} 和 {% tdk with name="Description" %} 标签调用，用于页面的 meta 标签，指导搜索引擎理解页面主题。同时，文档的 Description 字段也常常作为文章的摘要，可以直接通过 {{archive.Description}} 或 {% archiveDetail with name="Description" %} 显示在正文上方，引导读者。

  • 正文内容：灵活掌控

    • 文档内容 (Content)：这是文章的主体部分。显示时，必须注意安全和格式。
      • 如果文章内容包含HTML标签，为了避免它们被AnQiCMS模板引擎自动转义成纯文本，我们需要使用 |safe 过滤器，例如 {{archive.Content|safe}}。这样，正文中的图片、链接等HTML结构才能正常渲染。
      • 如果您的内容在后台是使用Markdown编辑器编写的，并且您希望在前端自动将其转换为HTML显示，可以在 archiveDetail 标签中添加 render=true 参数，例如 {% archiveDetail articleContent with name="Content" render=true %}{{articleContent|safe}}。这让Markdown语法得以正确解析。

  • 配图与封面：视觉焦点

    • 封面首图 (Logo) 和缩略图 (Thumb)：通常用于文章列表页或社交分享，但在详情页中，有时也需要显示一个主视觉图。它们可以通过 {{archive.Logo}} 和 {{archive.Thumb}} 来调用。
    • 封面组图 (Images)：如果一篇文章包含多张封面图片（例如产品详情页的轮播图），Images 字段会返回一个图片数组。您需要配合 for 循环标签来遍历并显示这些图片，例如： 
      
{% archiveDetail articleImages with name="Images" %}
{% for img in articleImages %}
    <img src="{{img}}" alt="{{archive.Title}}" />
{% endfor %}
    • 值得一提的是，这些图片如何处理（是否生成WebP格式、是否压缩、缩略图尺寸等），都可以在后台的“内容设置”中进行全局配置，从而影响前端的最终显示效果。

  • 时间、浏览量与其他基础信息

    • 发布时间 (CreatedTime) 和更新时间 (UpdatedTime)：通过 {{archive.CreatedTime}} 可以获取时间戳。为了将其格式化成易读的日期时间，可以使用 stampToDate 过滤器，例如 {{stampToDate(archive.CreatedTime, "2006-01-02 15:04")}}。
    • 浏览量 (Views)：直接使用 {{archive.Views}} 即可显示文章的阅读次数。
    • 分类信息 (Category)：文章所属的分类信息可以通过 archive.Category 对象获取，从而显示分类名称 (archive.Category.Title) 或分类链接 (archive.Category.Link)，用于面包屑导航或相关文章链接。

自定义与扩展：archiveParams 标签

除了AnQiCMS内置的字段外，我们还可以通过后台的“内容模型”功能，为文章或产品模型添加自定义字段，例如“文章作者”、“产品价格”、“产品特性”等。这些自定义字段是AnQiCMS灵活性的体现，它们在文章详情页的显示，则需要借助 archiveParams 标签。

  • 调用特定自定义字段：如果您知道自定义字段的名称（例如 author），可以直接通过 {% archiveDetail with name="author" %} 来获取并显示其值。
  • 循环显示所有自定义字段：如果您不确定有哪些自定义字段，或者希望动态显示它们，可以配合 for 循环来遍历： 
    
{% archiveParams params %}
{% for item in params %}
    <div>
        <span>{{item.Name}}：</span>
        <span>{{item.Value}}</span>
    </div>
{% endfor %}
    这在产品详情页显示产品参数时尤其有用。

丰富关联：标签与导航

为了提升用户体验和内容深度，文章详情页往往还会显示一些相关联的内容：