如何在 AnQiCMS 模板中利用 `tdk` 标签动态生成页面的 Title、Keywords 和 Description？
在当今内容爆炸的互联网环境中，搜索引擎优化（SEO）对于网站的可见性至关重要。而网站页面的 Title（标题）、Keywords（关键词）和 Description（描述），也就是我们常说的 TDK，是搜索引擎理解页面内容、决定是否展示给用户，以及用户是否点击的关键因素。在 AnQiCMS 这样一款专为中小企业和内容运营团队设计的内容管理系统中，灵活、动态地生成这些 TDK 信息，是提升网站 SEO 效果、优化用户体验的利器。
AnQiCMS 凭借其高效、可定制的特性，提供了强大的 SEO 工具，其中就包括对 TDK 的精细化控制。它不仅仅是一个静态的字段填写，更是一个可以根据页面类型、内容属性自动生成或手动覆盖的动态机制。接下来，我们将深入探讨如何在 AnQiCMS 的模板中，巧用 tdk 标签来动态生成页面的 Title、Keywords 和 Description。
AnQiCMS 如何管理 TDK 信息？
在 AnQiCMS 中，TDK 信息的管理是分层级的，这赋予了网站极高的灵活性：
全局默认设置（首页 TDK）： 首先，您可以在 AnQiCMS 后台的“后台设置” -> “首页 TDK 设置”中，为整个网站的首页配置默认的 Title、Keywords 和 Description。这些是网站最基础、最核心的 SEO 声明，当特定页面没有单独设置 TDK 时，系统可能会使用这些全局设置作为回退（尤其是在某些默认模板的首页）。
内容层级设置（文章、产品、单页面、分类、标签）： 除了全局设置，AnQiCMS 允许您在不同类型的内容编辑界面为每个具体页面定义独立的 TDK：
- 文档（文章、产品等）发布： 在添加或编辑文档时，您可以找到“SEO 标题”、“文档关键词”和“文档简介”等字段。其中，“SEO 标题”会作为 Title 的首选内容，而“文档简介”则通常用于 Description。
- 分类管理： 在创建或编辑分类时，同样有“SEO 标题”、“关键词”和“分类简介”等选项。这些设置将作用于该分类的列表页。
- 单页面管理： 对于“关于我们”、“联系我们”等独立页面，也有独立的“SEO 标题”、“关键词”和“单页面简介”供您配置。
- 文档标签： 即使是标签页，AnQiCMS 也提供了“SEO 标题”、“标签关键词”和“标签简介”的设置，确保每个页面都能得到优化。
这种分层管理机制意味着，您可以先设置一个通用的 TDK 策略，然后针对重要或特殊页面进行精细化调整，实现最优的 SEO 覆盖。
核心标签：tdk 的使用
AnQiCMS 的模板系统非常强大且易于上手，它采用类似 Django 模板引擎的语法。要动态获取并展示 TDK 信息，我们主要依赖的是 万能的 tdk 标签。
tdk 标签的基本用法是：{% tdk 变量名称 with name="字段名称" %}。其中，“变量名称”是可选的，如果您想将获取到的值赋值给一个变量以便后续处理，就可以指定它；如果不指定，则 tdk 标签会直接输出结果。name 参数则是指定您想要获取哪种 TDK 信息。
1. 动态生成页面 Title
页面的 Title 是最重要的 SEO 元素之一。使用 tdk 标签获取 Title 非常直观，并且 AnQiCMS 提供了丰富的参数来满足不同场景的需求。
要获取当前页面的 Title，通常会在模板的 <head> 区域内这样写：
<title>{% tdk with name="Title" %}</title>
但 AnQiCMS 赋予了 Title 更多动态特性：
附加网站名称： 很多网站的 Title 格式是“页面标题 - 网站名称”。您可以通过
siteName=true参数来自动追加网站名称：<title>{% tdk with name="Title" siteName=true %}</title>这样，如果您的页面标题是“AnQiCMS 教程”，网站名称是“安企CMS”，最终 Title 可能会显示为“AnQiCMS 教程 - 安企CMS”。
自定义分隔符： 默认情况下，网站名称和页面标题之间会使用短横线
-分隔。您可以使用sep参数来自定义分隔符：<title>{% tdk with name="Title" siteName=true sep="_" %}</title>此时，Title 将显示为“AnQiCMS 教程_安企CMS”。
显示父级分类标题： 对于具有层级结构的内容（如文章详情页），您可能希望 Title 包含其父级分类的名称，以提供更完整的上下文。
showParent=true参数可以实现这一点：<title>{% tdk with name="Title" siteName=true showParent=true %}</title>假设文章“动态生成 TDK”属于“模板制作”分类，那么 Title 可能显示为“动态生成 TDK - 模板制作 - 安企CMS”。这对于搜索引擎理解页面主题的广度和深度非常有帮助。
通过组合这些参数，您可以为网站的 Title 实现高度定制化的动态生成策略，无论是首页、分类页还是详情页，都能自动适应并展示最符合 SEO 需求的 Title。
2. 动态生成页面 Keywords
Keywords 标签虽然在现代 SEO 中的权重有所下降，但它仍然能为搜索引擎提供页面主题的辅助信息。在 AnQiCMS 中，Keywords 会从页面对应的后台设置（文章关键词、分类关键词等）中自动获取。
在模板中，您可以这样引入 Keywords：
<meta name="keywords" content="{% tdk with name="Keywords" %}">
或者，如果您希望将关键词内容赋值给一个变量：
{% tdk seoKeywords with name="Keywords" %}
<meta name="keywords" content="{{seoKeywords}}">
确保您在后台为每个页面设置了相关的关键词，它们会在这里被动态提取和展示。
3. 动态生成页面 Description
Description 标签是搜索引擎结果页中 Title 下方显示的摘要，它直接影响用户的点击意愿。清晰、有吸引力的 Description 对提升点击率至关重要。AnQiCMS 同样会从页面对应的后台设置（文档简介、分类简介等）中自动获取。
在模板中，您可以这样引入 Description：
<meta name="description" content="{% tdk with name="Description" %}">
与 Keywords 类似，您也可以将其赋值给一个变量：
{% tdk seoDescription with name="Description" %}
<meta name="description" content="{{seoDescription}}">
一个好的 Description 应该简洁明了地概括页面内容，并包含相关关键词，吸引潜在访客点击。
4. 动态生成规范链接 (Canonical URL)
规范链接（Canonical URL）是 SEO 的一个高级概念，它用于告诉搜索引擎一个页面的“首选”URL，以避免因内容重复（如同一篇文章有多个 URL 路径、分页内容等）而导致的 SEO 负面影响。AnQiCMS 同样支持为页面动态生成 Canonical URL。
由于并非所有页面都需要或会有独立的 Canonical URL，**实践是先判断其是否存在，再进行设置：
{%- tdk canonical with name="CanonicalUrl" %}
{%- if canonical %}
<link rel="canonical" href="{{canonical}}" />
{%- endif %}
这段代码会尝试获取当前页面的 Canonical URL，如果后台有设置（例如在文档编辑界面），它就会被渲染出来，否则不会输出，避免了不必要的空标签。
实践案例与**实践
为了让 TDK 配置更加高效和统一，我们强烈建议您在 AnQiCMS 模板中创建一个公共的头部文件（例如 partial/_header.html），并将所有 TDK 相关的标签集中放置其中，然后通过 {% include "partial/_header.html" %} 的方式在所有页面中引用。
一个典型的 partial/_header.html 示例可能如下：
”`twig <!DOCTYPE html>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{% tdk with name="Title" siteName=true showParent=true %}</title>
<meta name="keywords" content="{% tdk with name="Keywords" %}">
<meta name="description" content="{% tdk with name="Description" %}">
{%- tdk canonical with name="CanonicalUrl" %}
{%- if canonical %}
<link rel="canonical" href="{{canonical}}" />