跳至内容
站点信息与 SEO

站点信息与 SEO

控制站点描述和搜索引擎(如 Google、Bing)爬取规则。

站点描述

为站点提供一个简短的描述。它会出现在搜索引擎结果页的预览中,也会被用作 RSS 订阅源的描述。

hugo.toml 中设置:

[params]
  # 说明:简短的站点描述。
  description = 'Tralume: 一款现代、轻量、美观的 Hugo 主题。'

Favicon(网站图标)

Tralume 可以通过 params.favicon 输出网站图标。将相关图标文件放入站点的 static/ 目录,然后使用相对站点根目录的路径引用它们:

[params.favicon]
  icon = '/favicon.ico'
  svg = '/favicon.svg'
  appleTouch = '/apple-touch-icon.png'
  manifest = '/site.webmanifest'

支持的字段:

  • icon:常规站标,通常为 .ico.png
  • svg:供新版浏览器使用的 SVG 站标
  • appleTouch:iOS 添加到主屏幕的图标
  • manifest:Web 应用清单文件

社交媒体分享卡片 (Open Graph / Twitter Card)

Tralume 会自动为每个页面生成 Open Graph 与 Twitter Card 元信息。

主题按以下优先级顺序解析分享图片:

  1. 页面级别 Front Matterimage > featuredImage > featured_image > cover > thumbnail > banner > Page Bundle 中第一张图片资源
  2. 站点级别参数(按顺序):params.socialImage > params.seo.image > params.seo.cardImage
  3. 兜底params.favicon.appleTouch > params.favicon.icon > 无图片

设置全站默认分享图:

[params]
  # 说明:全站默认的社交分享卡片图。
  # 注意:此参数在站点级别中有最高优先级。
  socialImage = '/social-card.png'

也可以通过 params.seo 设置默认分享图:

[params.seo]
  # 说明:全站默认社交分享卡片图。
  # 注意:推荐使用 1200x630 分辨率的图片。
  # 注意:image 的优先级高于 cardImage。
  image = '/seo-default.png'
  cardImage = '/social-card.png'

如需使用任意受支持的页面级图片字段,在其 Front Matter 中这样写:

+++
# 说明:仅覆盖当前页面的社交分享卡片图。
# 注意:image、featuredImage、featured_image、cover、thumbnail、banner 均可生效。
featuredImage = '/posts/example/cover.png'
+++

结构化数据 author 与 publisher (JSON-LD)

Tralume 会为首页和文章页生成 JSON-LD。

  • 文章页可包含 author
  • 首页和文章页可包含 publisher
  • publisher.logo 可以显式设置,留空时依次回退到 params.seo.logo > params.favicon.appleTouch > params.favicon.icon

hugo.toml 中设置全站作者与发布者:

[params.seo.author]
  # 说明:文章页默认作者名。
  name = 'AlexMa'
  # 说明:作者个人页面或关于页 URL。
  url = 'https://example.com/about/'

[params.seo.publisher]
  # 说明:用于结构化数据的发布者名称。
  name = 'AlexMa\'s Blog'
  # 说明:发布者主页 URL。
  url = 'https://example.com/'
  # 说明:发布者 Logo 图片。
  # 注意:请使用稳定的绝对 URL 或站点根相对路径。
  logo = '/publisher-logo.png'

如需覆盖某一篇文章的作者,在其 Front Matter 中这样写:

+++
# 说明:仅覆盖当前文章的结构化数据作者。
[author]
  name = 'Guest Author'
  url = 'https://example.com/team/guest-author/'
+++

Robots 控制 (robots.txt)

告诉搜索引擎哪些页面可以抓取。你也可以在公开发布前暂时禁止全站抓取。

hugo.toml 下开启 Hugo 自身的 robots.txt 生成能力:

enableRobotsTXT = true

[params.robotsTxt]
  # 说明:是否允许搜索引擎抓取。
  # 设为 false 则全站禁止爬取 (Disallow: /)。
  enabled = true

  # 说明:是否在 robots.txt 中包含 sitemap 链接。
  sitemap = true
最后更新于 • alexma233