如何在AnQiCMS中自定义文章详情页面的显示布局？
在使用AnQiCMS管理网站内容时，文章详情页的布局和展示效果直接影响着用户体验。AnQiCMS为我们提供了高度的灵活性，让我们可以根据不同类型的内容或特定文章的需求，自定义其详情页的显示布局，而无需受限于单一的模板样式。
要实现文章详情页的个性化布局，我们主要会用到AnQiCMS的模板机制和内容管理功能。核心思路是：在模板文件中定义多种布局结构，然后在后台编辑文章时选择对应的布局。
灵活的模板文件：自定义布局的基础
AnQiCMS的模板文件统一存放在网站根目录下的 /template 文件夹中。每个模板主题都有自己的独立目录。在这里，文章详情页的默认模板通常是 your_theme_name/{模型table}/detail.html。例如，如果是文章模型，默认就是 your_theme_name/article/detail.html。
然而，如果我们需要为某一篇文章或者某一类文章定制独特的布局，AnQiCMS允许我们创建自定义的模板文件。这些自定义文件可以放在与 detail.html 同级的目录下，或者在 detail.html 所在模型的文件夹内，以更具体的文件名命名。例如，我们可以创建 article/download.html 或者 product/detail-product-showcase.html 等。AnQiCMS还支持一种“文件夹组织模式”，你可以在 {模型table} 目录下创建更细致的子目录来存放模板，比如 article/special/detail.html。
实现文章详情页自定义布局的步骤
让我们一步步来看看如何操作：
第一步：规划自定义模板文件
首先，考虑你的文章或产品需要什么样的独特布局。例如，你可能需要一个特别的下载页面，一个带有产品参数对比的页面，或者一个活动报名页面。
根据规划，进入你当前使用的模板主题文件夹（例如 template/default）。在你想要自定义布局的模型文件夹内（比如 article 文件夹），创建新的HTML文件。文件名可以根据其用途来命名，比如 article/download.html 用于下载类文章的详情页，或者 article/event.html 用于活动文章。
第二步：在自定义模板中构建布局和内容
打开你新创建的HTML文件（例如 article/download.html），在这里你可以像设计任何HTML页面一样，构建你的专属布局。AnQiCMS强大的模板标签体系是填充内容的利器。
在自定义详情页中，最核心的标签莫过于 {% archiveDetail %}。它能够获取当前文章的所有详细信息。你可以这样来显示文章的标题、内容、图片等：
{# 显示文章标题 #}
<h1>{% archiveDetail with name="Title" %}</h1>
{# 显示文章发布时间 #}
<p>发布时间：{% archiveDetail with name="CreatedTime" format="2006年01月02日" %}</p>
{# 显示文章内容，注意使用 |safe 过滤器确保HTML内容正确解析 #}
<div class="article-content">
{% archiveDetail articleContent with name="Content" %}
{{ articleContent|safe }}
</div>
{# 如果文章有缩略图，可以这样显示 #}
{% archiveDetail articleThumb with name="Thumb" %}
{% if articleThumb %}
<img src="{{ articleThumb }}" alt="{% archiveDetail with name="Title" %}">
{% endif %}
除了文章自身的字段，你还可以利用其他标签获取更多相关信息：
- 获取分类信息：
{% categoryDetail with name="Title" %}可以显示文章所属分类的名称。 - 获取文章标签：使用
{% tagList %}标签循环显示文章关联的标签。 - 获取自定义参数：如果你在后台为文章模型添加了额外的自定义字段（例如“作者”、“产品参数”等），可以使用
{% archiveParams %}标签来循环展示这些字段，或者直接使用{% archiveDetail with name="你的自定义字段名" %}来获取特定字段的值。 - 上下篇文章导航：
{% prevArchive %}和{% nextArchive %}标签能帮助你创建文章间的跳转链接，提升用户浏览体验。 - 全局系统信息：
{% system with name="SiteName" %}可以获取网站名称等全局设置。
第三步：在后台文章编辑页面关联自定义模板
完成了自定义模板文件的创建和内容填充后，最后一步是让AnQiCMS知道哪些文章应该使用这个新模板。
当你进入后台编辑或发布文章的界面时，在“其他参数”部分，你会找到一个名为“文档模板”的字段。在这个字段中，填入你自定义模板文件的相对路径和文件名。例如，如果你创建的文件是 template/default/article/download.html，那么在这里就填写 download.html。如果你放在了子文件夹中，比如 template/default/article/special/detail.html，那么就填写 special/detail.html。
保存文章后，再次访问该文章的详情页，你就会发现它已经使用了你精心设计的自定义布局了。
批量应用自定义布局的场景
有时候，你可能希望某个分类下的所有文章都使用特定的自定义模板，而不是为每篇文章单独设置。AnQiCMS也考虑到了这一点。在后台的“文档分类”管理页面，编辑某个分类时，在“其他参数”中，你会看到一个“分类模板”字段。在这里填写自定义模板的文件名，例如 download.html。同时，勾选“是否应用到子分类”选项，该分类及其所有子分类下的文章都将默认使用这个自定义模板，除非单篇文章自己单独指定了模板。
通过以上方法，AnQiCMS提供了从单篇文章到分类文章的多种自定义布局方案，让我们的网站内容展示更加丰富和个性化。
常见问题 (FAQ)
问：自定义模板文件应该放在AnQiCMS的哪个目录下？ 答： 自定义模板文件应放在你当前使用的模板主题目录内，通常在
/template/你的主题名/之下，然后根据内容模型（如文章article、产品product）将其放置在对应的模型文件夹中。例如，文章详情页的自定义模板可以放在template/default/article/目录下。问：如果我想针对某个分类下的所有文章使用同一个自定义模板，应该怎么操作？ 答： 你可以在后台进入“内容管理”下的“文档分类”，编辑目标分类。在分类的“其他参数”中找到“文档模板”字段，填写你的自定义模板文件名（例如
custom_list.html）。如果你希望其子分类也继承此设置，请勾选“是否应用到子分类”选项。问：自定义模板中如何获取文章内容以外的其他字段（比如我在后台为文章模型添加了“作者”字段）？ 答： 如果你在后台的文章模型中自定义了字段，在文章详情页的自定义模板中，你可以直接使用
{% archiveDetail with name="你的字段名" %}来获取其值。例如，如果你添加了一个名为author的字段，就可以用{% archiveDetail with name="author" %}来显示作者。如果你想循环显示所有自定义字段，可以使用{% archiveParams params %}标签来实现。