如何在AnQiCMS模板中调用和显示页面的TDK（标题、关键词、描述）信息？
在网站运营中，TDK（Title, Keywords, Description）信息扮演着至关重要的角色，它们直接影响着网站在搜索引擎中的可见度和点击率。作为网站对外展示的“名片”，TDK的合理设置是SEO优化的基石。AnQiCMS作为一个专注于SEO优化的内容管理系统，自然为用户提供了灵活且强大的TDK管理与调用功能。
AnQiCMS中的TDK管理机制
AnQiCMS深知TDK的重要性，因此在系统设计中，对TDK的设置进行了细致的划分和层级管理。您可以在多个层面为网站设置TDK信息，确保每个页面都能拥有独特且精准的元数据：
- 全站首页TDK： 在后台的“后台设置” -> “首页TDK设置”中，您可以为整个网站的首页配置统一的标题、关键词和描述。这是网站最基础的TDK设置，对品牌宣传和核心业务关键词的覆盖至关重要。
- 内容页面TDK： 无论是文章、产品详情页，还是单独的分类页面、自定义单页面，AnQiCMS都允许您进行独立的TDK设置。在编辑这些内容时，通常会看到“SEO标题”、“关键词”和“简介/描述”等字段，这些就是用于覆盖该页面的TDK信息。例如，在“添加文档”时，有“SEO标题”和“文档关键词”；在“文档分类”设置中，有“分类简介”和“关键词”等，这些都会优先于首页TDK在对应页面生效。
- 规范链接（Canonical URL）： 除了传统的TDK，AnQiCMS还提供了设置规范链接的功能。规范链接可以有效避免因内容重复而导致的SEO问题，指示搜索引擎哪个是页面的“权威”版本。
这种分层管理机制确保了每个页面的TDK都能根据其内容的独特性进行优化，极大地提升了网站的SEO表现力。
在AnQiCMS模板中调用TDK信息
AnQiCMS使用类似于Django的模板引擎语法，通过特定的标签来调用和显示TDK信息。这个“万能”标签就是{% tdk %}。通常，这些TDK标签会放置在模板文件的<head>区域内，以便浏览器和搜索引擎能够正确识别。
调用页面标题（<title>）
页面的标题通常包含最重要的信息，也是搜索引擎结果中显示的最大文字。在AnQiCMS模板中，您可以使用以下方式调用页面标题：
<title>{% tdk with name="Title" %}</title>
此外，{% tdk with name="Title" %}标签还支持一些实用的属性，让标题显示更加灵活：
附加网站名称： 如果您希望在页面标题的末尾自动加上网站的名称，可以使用
siteName=true属性。例如：<title>{% tdk with name="Title" siteName=true %}</title>这样，一个文章页面的标题可能是“我的文章标题 - AnQiCMS”，而无需手动拼接。
自定义分隔符： 默认情况下，网站名称和页面标题之间使用“-”作为分隔符。您可以通过
sep属性自定义分隔符，例如使用下划线_：<title>{% tdk with name="Title" sep="_" siteName=true %}</title>显示上级分类标题： 对于分类页面，有时您可能希望在标题中体现其上级分类的名称，这时可以使用
showParent=true：<title>{% tdk with name="Title" showParent=true %}</title>
调用页面关键词（<meta name="keywords">）
关键词标签用于向搜索引擎提供页面内容的关键词提示。虽然其权重已不如以往，但合理设置仍不失为一种良好实践。
<meta name="keywords" content="{% tdk with name="Keywords" %}">
调用页面描述（<meta name="description">）
页面描述是搜索引擎结果中标题下方的一段简短摘要，直接影响用户的点击意愿。
<meta name="description" content="{% tdk with name="Description" %}">
调用规范链接（<link rel="canonical">）
规范链接有助于解决重复内容问题，指导搜索引擎识别页面的主要版本。
{%- tdk canonical with name="CanonicalUrl" %}
{%- if canonical %}
<link rel="canonical" href="{{canonical}}" />
{%- endif %}
这里，我们首先将CanonicalUrl的值赋给一个变量canonical，然后通过{% if canonical %}判断该链接是否存在，只有存在时才渲染<link rel="canonical">标签，这是一种更严谨和推荐的做法。
实际应用与**实践
为了确保TDK信息在所有页面都能正确显示，建议将上述TDK标签放置在您的通用模板文件（例如bash.html或header.html）的<head>区域内。AnQiCMS的模板继承机制使得这些全局设置可以轻松地应用于所有继承了该基础模板的页面。
在进行TDK设置时，请记住以下几点：
- 独特性： 尽量确保每个页面的TDK都是独一无二的，避免重复。
- 相关性： 标题、关键词和描述都应与页面内容高度相关。
- 可读性： 描述信息不仅是给搜索引擎看的，更是给用户看的，力求简洁、吸引人。
- 长度限制： 遵守搜索引擎对标题和描述的字符长度建议，避免内容被截断。
通过AnQiCMS提供的强大TDK管理和灵活的模板调用机制，您可以有效地对网站进行SEO优化，提升网站在搜索引擎中的表现。
常见问题 (FAQ)
问：为什么我设置了某个文章的TDK，但页面上显示的还是首页的TDK？ 答： AnQiCMS在TDK的处理上遵循一定的优先级规则。通常，页面自身设置的TDK（如文章、分类、单页的独立设置）会优先于其上级（如分类TDK优先于首页TDK）或全站的默认TDK。如果您发现设置不生效，请首先检查该页面的TDK是否已正确填写并保存，其次检查模板中TDK标签是否正确调用。如果页面没有设置特定TDK，系统会自动向上查找，直到找到可用的TDK信息（例如，文章没有设置TDK，则会尝试使用其所属分类的TDK；分类也没有，则会使用首页TDK）。
问：我在模板中添加了
{% tdk %}标签，但页面源码中没有显示相应的TDK信息，是什么原因？ 答： 这通常有几个原因：- 标签拼写错误： 检查
{% tdk %}标签及其属性name是否完全正确，包括大小写。 - TDK内容未设置： 页面或其上级层级在后台可能没有设置对应的标题、关键词或描述内容，导致标签输出为空。
- 模板文件位置不正确： TDK标签应放在HTML文档的
<head>区域内，如果放错位置，可能导致浏览器无法解析或渲染。 - 缓存问题： AnQiCMS可能存在页面缓存，导致新修改的模板或内容未立即生效。尝试在后台清除网站缓存或刷新页面。
- 标签拼写错误： 检查
问：我能否在页面描述中动态插入文章的标签或发布日期等信息？ 答：
{% tdk %}标签本身是用于直接调用已设置好的TDK字段。如果您希望动态组合页面描述或关键词，您需要在模板中先获取所需的数据（例如使用{% archiveDetail %}获取文章信息或{% tagList %}获取标签），然后将这些信息通过{% set %}或{% with %}标签组合成一个新的字符串变量，最后再将这个变量赋值给TDK字段。不过，直接修改后台设置的TDK字段会更简单直接，而动态组合通常用于高度定制化的SEO需求。例如：{% archiveDetail currentArchive with name="Description" %} {% tagList tags with itemId=currentArchive.Id %} {% set customDescription = currentArchive.Description ~ "，标签有：" %} {% for item in tags %} {% set customDescription = customDescription ~ item.Title ~ " " %} {% endfor %} <meta name="description" content="{{ customDescription|trim }}">这种方式虽然灵活，但在实际操作中应确保生成内容的准确性和唯一性。