Z-Blog 主题的 SEO 基础：canonical、description 与结构化数据

主题层面能做的 SEO 其实不多，但漏掉关键的几项，收录效果会明显变差。

一、canonical 标签

列表分页、带参数的 URL 容易产生重复内容，需要指定规范地址：

<link rel="canonical" href="{$article.Url}">

首页和分类页要分别处理，别全站写死同一个地址，那样会被判为作弊。

二、description

Z-Blog 文章有摘要字段，优先用摘要，没有则截取正文：

<meta name="description" content="{$article.Intro}">

注意两点：摘要里可能带 HTML，输出前要过滤标签；超过 120 字会被搜索引擎截断，超长部分写在后面没意义。

三、标题结构

• 全站只能有一个 <h1>，通常是站点名或文章标题
• 正文里的小标题从 <h2> 开始，不要跳级用 <h4>
• Z-Blog 默认主题有时会把站名和文章标题都用 h1，需要自己改

四、结构化数据

文章页加一段 JSON-LD：

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "{$article.Title}",
  "datePublished": "{$article.Time('c')}"
}
</script>

JSON 里不能有未转义的双引号，文章标题中含引号会导致解析失败，需要提前做转义处理。

五、别忘了 sitemap

Z-Blog 本身不带 sitemap，需要装插件或自己输出。主题层面不解决这一项，但要在文档里提醒用户去配。