Zola结构化数据3步落地让搜索结果展示文章摘要与作者【免费下载链接】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 静态网站生成器为例用3步完成一次最小可用的结构化数据接入在模板里输出 JSON-LD 格式的 Schema.org 标记让搜索引擎在搜索结果中展示文章标题、摘要、作者与发布日期。Zola 本身不内置该功能但它的 Tera 模板系统提供了完成此事所需的全部变量。✅ 最终效果预览完成后每篇文章的 HTML 头部会多出一段application/ldjson脚本搜索引擎据此在搜索结果中展示富信息卡片用 Google 的结构化数据测试工具打开页面能直接看到被识别的 Article 类型及其字段。仓库文档中的 Adidoks 主题就是一个真实示例它通过[extra.schema]配置向页面注入 JSON-LD动手前确认一个可正常运行的 Zola 站点包含templates、content目录和config.toml执行zola serve无报错。config.toml中已填写description并预留[extra]段存放站点级信息。浏览器已安装开发者工具方便查看渲染后的 HTML。目录约定与模板机制详见 官方文档目录结构 和 模板概览。 最短实现路径Article 标记三步接入第1步创建 templates/schema/article.html在templates下新建schema/article.html内容如下script typeapplication/ldjson { context: https://schema.org, type: Article, headline: {{ page.title }}, description: {{ page.description | default(valueconfig.description) }}, author: { type: Person, name: {{ page.extra.author | default(valueconfig.extra.author) }} }, datePublished: {{ page.date | date(format%Y-%m-%d) }} } /script这段代码用{{ page.* }}取出每篇文章的标题、描述与日期default过滤器在页面没写description或extra.author时回退到config.toml里的站点级值保证字段始终有内容。第2步在页面模板中引入并补充站点配置在templates/page.html的head中加入一行引入并在config.toml补充作者{% include schema/article.html %}[extra] author 你的名字引入语句让所有走page.html的页面自动携带该标记如需只对文章生效可用{% if %}按current_path包一层条件。站点标题、Logo 等字段通过config.title、get_url()内置函数取到后可按同样方式补进模板。场景速查按页面类型选 Schema 类型页面场景type关键字段取数来源博客文章Articleheadline、datePublished、authorpage.title、page.date、page.extra首页WebSitename、url、potentialActionconfig.title、config.base_url产品介绍页Productname、offers、brandpage.extra下的价格等字段关于页Organizationname、urlconfig.extra做法都一样每种类型单独建一个templates/schema/xxx.html再在对应模板中 include。仓库里的 Academic Paper 主题即为博客场景的完整参考其 说明文档 明确列出 JSON-LD 元数据属于主题特性自检与排错如何验证 Zola 结构化数据生效执行zola serve后访问任意文章页用开发者工具查看源码中的application/ldjson段再将其内容粘贴到 Google 结构化数据测试工具中校验。常见问题对照如下症状原因处理源码中找不到 ldjson 脚本引入没写进实际使用的模板或条件不成立确认文章真正渲染的是page.html必要时用 front matter 的template字段核对测试工具提示缺少必填字段Article 缺少 headline 或 datePublished 等按工具报出的字段名逐个补齐校验通过但搜索结果仍是普通卡片搜索引擎尚未重新抓取索引提交站点地图后等待数天期间无需改代码工具报 JSON 解析错误模板里的引号、花括号未闭合或字段值含未转义引号先手动核对生成出的 JSON再改模板下一步在 模板文档 中确认各模板可用的config、current_url、page变量把 WebSite 标记加到首页模板。用zola build完整构建一次抽查public目录下的 HTML确认静态产物里标记无误。需要更多主题级示例时参考 AdiDoks 主题文档 中[extra.schema]的用法。【免费下载链接】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），仅供参考