如何在模板中动态显示当前页面对应的规范链接（Canonical URL）？
在网站运营中，保持搜索引擎友好性是提升网站可见度的关键环节之一。其中，“规范链接”（Canonical URL）扮演着至关重要的角色。它就像搜索引擎的指南针，告诉它们哪个页面是内容的“主版本”，从而有效避免因内容重复或相似而导致的排名分散问题。对内容运营者而言，正确地设置和显示规范链接，是确保网站内容被搜索引擎高效抓取和索引的基石。
安企CMS（AnQiCMS）作为一个专注于企业级内容管理和SEO优化的系统，自然考虑到了规范链接的重要性。当您在后台编辑文章、产品或其他文档时，在文档的“其他参数”部分，您会找到一个名为“规范的链接”的字段。这里允许您手动为当前页面指定一个规范的URL。这意味着，如果您有内容相似的页面，或者页面存在多种访问路径（例如带参数的URL），您可以在这里明确指定哪一个是您希望搜索引擎索引的权威版本。这对于国际站点的多语言版本，或带有追踪参数的营销页面尤为有用。
那么，如何将这个在后台设置的规范链接动态地呈现在网站前端的HTML代码中呢？安企CMS提供了简洁高效的模板标签来实现这一点。通常，规范链接会放置在页面的 <head> 区域，以 <link rel="canonical" href="[您的规范链接]" /> 的形式存在。
在安企CMS的模板系统中，您可以使用 tdk 标签来获取页面的规范链接。 tdk 标签设计之初就是为了集中管理页面的标题（Title）、关键词（Keywords）和描述（Description）等元信息，它也方便地集成了对规范链接 CanonicalUrl 的获取。
要动态显示当前页面的规范链接，您只需在模板文件的 <head> 部分加入以下代码片段：
{%- tdk canonical_url with name="CanonicalUrl" %}
{%- if canonical_url %}
<link rel="canonical" href="{{ canonical_url }}" />
{%- endif %}
让我们来解释一下这段代码的作用：
首先，{%- tdk canonical_url with name="CanonicalUrl" %} 这行代码尝试从当前页面的元信息中获取名为 CanonicalUrl 的值，并将其赋值给一个名为 canonical_url 的变量。这里的 {%- 和 -%} 用于移除标签行产生的空白，使生成的HTML代码更加整洁。
紧接着，{%- if canonical_url %} 这行是一个条件判断。它的作用是检查 canonical_url 变量是否为空。只有当您在后台的“规范的链接”字段中填写了内容，这个变量才会有值。
如果 canonical_url 有值，那么 <link rel="canonical" href="{{ canonical_url }}" /> 这行代码才会被渲染到页面上，其中 {{ canonical_url }} 会被替换为实际的规范链接地址。这种条件渲染确保了只有当有明确的规范链接时，页面才会输出该标签，避免了输出一个空的或不必要的规范链接标签。
您通常会将这段代码放置在您的通用头部模板文件（例如 template/您的模板名/partial/header.html 或 bash.html）的 <head> 标签内部。这样，无论哪个页面调用这个头部模板，都能自动检查并显示其对应的规范链接。
通过这种方式，安企CMS帮助您轻松地管理网站的SEO关键元素。您可以在后台灵活地为每个页面指定其规范链接，而模板则会智能地识别并输出这些信息，确保搜索引擎能够准确理解您网站内容的权威版本，从而优化您的网站在搜索结果中的表现。
常见问题（FAQ）
问：为什么我的页面没有显示规范链接标签？ 答：首先，请检查您在安企CMS后台编辑相关文档时，“其他参数”部分的“规范的链接”字段是否已正确填写。如果该字段为空，模板中的条件判断（
{%- if canonical_url %}）将阻止其渲染。其次，请确保您已将上述代码片段正确添加到了您模板文件的<head>区域，并且模板缓存已更新。问：我应该在所有页面都设置规范链接吗？ 答：并非所有页面都需要手动设置规范链接。对于内容唯一且没有其他访问路径的页面，搜索引擎通常能够正确识别其权威性。但是，对于那些内容高度相似、存在多个带参数URL的页面（如筛选、排序结果页）、分页内容系列中的非第一页，或者您的网站存在PC和移动端内容重复的情况，明确设置规范链接就显得非常重要。它有助于将页面权重集中到您指定的主版本，避免因重复内容而分散排名。
问：如果我没有手动设置“规范的链接”字段，安企CMS会自动生成一个吗？ 答：安企CMS不会在您未手动设置的情况下自动生成一个
<link rel="canonical">标签。它会优先尊重您在后台的明确配置。如果您未填写该字段，通过tdk标签获取到的CanonicalUrl将为空值，此时模板中的条件判断会确保不输出该标签。这让您能完全掌控每个页面的规范链接策略。