Zola 结构化数据实战：让搜索结果长出摘要和作者
【免费下载链接】zolaA fast static site generator in a single binary with everything built-in. https://www.getzola.org项目地址: https://gitcode.com/GitHub_Trending/zo/zola
在搜索引擎里输入同一个关键词，排在你前面的竞品，文章条目下方带着摘要、作者和发布日期，甚至还有星级评分；而你的博客只有一行干巴巴的标题。差别通常不在内容，而在对方给页面加了 Zola 结构化数据，也就是 Schema.org 标记——搜索引擎靠它理解页面，再用富摘要展示。
为什么 Zola 没有内置 Schema.org，怎么办
先说清楚一个事实：Zola 定位是极快的静态站点生成器，功能面收窄，config.toml里没有任何结构化数据相关选项，默认产物里也找不到 JSON-LD。
但这不是坏消息。Zola 用 Tera 模板引擎渲染页面，而 JSON-LD（一段塞在<head>里、给机器读的结构化数据脚本）本质就是几行 HTML。换句话说：你不需要等官方功能，模板里手写即可。
从页面类型到 Schema.org 类型的速查全景
动手之前先建立全局认知，不同页面用不同的 Schema 类型，别拿 Product 去标博客：
| 你的页面 | Schema.org 类型 | 核心字段 |
|---|---|---|
| 博客文章 | Article | headline、author、datePublished |
| 站点首页 | WebSite | name、url、potentialAction |
| 商品页 | Product | name、offers、image |
| 活动页 | Event | name、startDate、location |
| 公司介绍 | Organization | name、logo、sameAs |
| 作者主页 | Person | name、jobTitle、worksFor |
实操：把 Schema.org 标记写进 Zola 模板
JSON-LD 模板注入位置与 Tera 变量速查
落点只有一个地方：模板的<head>里。参考仓库里的模板结构，test_site/templates/page.html 就是文章模板，把<script>块贴进它的<head>即可；完整变量清单可查 docs/content/documentation/templates/overview.md。
写之前记住这几个 Tera 变量，后面代码全靠它们：
page.title/page.description：文章标题、摘要，来自 Markdown 前置元数据page.date/page.updated：发布日期、更新日期，后者未填时要用default兜底page.taxonomies.tags：文章打过的标签列表page.extra.author：自定义字段，适合存作者名current_url：当前页面的完整 URL，Zola 渲染时自动注入config.title/config.description/config.base_url：站点级信息
Article 与 WebSite 标记的最小可用代码
第一段：给文章页输出 Article 标记，贴进page.html的<head>。
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "{{ page.title }}", {# 摘要：页面没写就用站点描述兜底，避免空值 #} "description": "{{ page.description | default(value=config.description) }}", "datePublished": "{{ page.date | date(format='%Y-%m-%d') }}", "author": { "@type": "Person", "name": "{{ page.extra.author | default(value=config.extra.author) }}" }, "image": [ "https://your-domain.com/cover.jpg" {# 需要动态生成时，可遍历 page.assets 过滤本地图片再拼进这个数组 #} ], {# current_url 是 Zola 注入的当前页面完整地址 #} "mainEntityOfPage": "{{ current_url }}" } </script>第二段：给首页输出 WebSite 标记，并声明站内搜索供富摘要使用，贴进index.html的<head>。
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebSite", "name": "{{ config.title }}", "url": "{{ config.base_url }}", "description": "{{ config.description }}", "potentialAction": { "@type": "SearchAction", "target": "{{ config.base_url }}/search?q={search_term_string}", "query-input": "required name=search_term_string" } } </script>把标记抽成可复用的 include 组件
标记一多，直接内联会让模板变臃肿。约定一个目录：templates/schema/，每种类型一个文件，比如article.html、website.html、product.html，内容就是上面带<script>的整块。
然后按页面归属的 section 条件引入，page.html的<head>末尾写：
{# 文章区才输出 Article 标记 #} {% if page.section == "posts" %} {% include "schema/article.html" %} {% endif %} {# 组织信息全站通用，直接包含 #} {% include "schema/organization.html" %}🧩 这样做的好处：换文章标记格式只改schema/article.html一个文件，模板本体零改动。
验证结构化数据与常见报错排查
两步验证：zola serve + Rich Results Test
- 本地跑
zola serve，打开http://localhost:1111的任意文章页，F12查看源码，确认<script type="application/ld+json">真的被渲染出来了，且花括号内没有残留{{。 - 把页面 HTML 粘进 Google Rich Results Test，看是否报 error 或 warning。
结构化数据标记常见坑清单
- 尾逗号：JSON 最后一个字段后多一个逗号，整个块直接解析失败。
- 变量没兜底：
page.updated没填时 Tera 输出空字符串，dateModified就变成""，记得加| default(value=page.date)。 - assets 过滤写错：想从
page.assets里筛本地图片时，过滤条件过严会导致image数组为空，先打印变量再调条件。 - 全角标点混入：中文输入法下敲的全角逗号
，会让 JSON 非法，肉眼很难发现。 - 重复标记：主题模板里已经写过一次 JSON-LD，你又内联一段，同类型字段互相冲突。
回看开头那个对比场景：你需要的不是换主题，而是让搜索引擎"读懂"页面。下一步就从最近的一篇博客开始——把 Article 代码贴进page.html，zola serve验证通过后再上首页的 WebSite 标记，一天内让搜索结果长出摘要、作者和日期。
【免费下载链接】zolaA fast static site generator in a single binary with everything built-in. https://www.getzola.org项目地址: https://gitcode.com/GitHub_Trending/zo/zola
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
