Skip to content
Bernard's Blog
Go back

AstroPaper 博客文章中的动态 OG 图片生成

Updated:

AstroPaper v1.4.0 的新功能,引入了博客文章的动态 OG 图片生成。

目录

介绍

OG 图片(也称为社交图片)在社交媒体互动中扮演着重要角色。如果你不知道 OG 图片是什么,它是在我们在 Facebook、Discord 等社交媒体上分享网站 URL 时显示的一张图片。

Twitter 使用的社交图片技术上不称为 OG 图片。不过,在本文中,我将使用 OG 图片来指代所有类型的社交图片。

默认/静态 OG 图片(旧方式)

AstroPaper 已经提供了一种为博客文章添加 OG 图片的方式。作者可以在前置元数据 ogImage 中指定 OG 图片。即使作者没有在前置元数据中定义 OG 图片,也会使用默认的 OG 图片作为后备(在本例中为 public/astropaper-og.jpg)。但问题是,默认的 OG 图片是静态的,这意味着每篇没有在前置元数据中包含 OG 图片的博客文章都将始终使用相同的默认 OG 图片,尽管每篇文章的标题/内容各不相同。

动态 OG 图片

为每篇文章生成动态 OG 图片可以让作者避免为每篇博客文章指定 OG 图片。此外,这可以防止后备 OG 图片对所有博客文章都相同。

在 AstroPaper v1.4.0 中,使用了 Vercel 的 Satori 包来生成动态 OG 图片。

动态 OG 图片将在构建时为满足以下条件的博客文章生成:

AstroPaper 动态 OG 图片的构成

AstroPaper 的动态 OG 图片包含_博客文章标题_、作者名称_和_网站标题。作者名称和网站标题将通过 “src/config.ts” 文件中的 SITE.authorSITE.title 获取。标题则从博客文章前置元数据 title 生成。

示例动态 OG 图片链接

非拉丁字符问题

包含非拉丁字符的标题默认无法正确显示。要解决这个问题,我们需要将 loadGoogleFont.ts 中的 fontsConfig 替换为你偏好的字体。

async function loadGoogleFonts(
  text: string
): Promise<
  Array<{ name: string; data: ArrayBuffer; weight: number; style: string }>
> {
  const fontsConfig = [
    {
      name: "Noto Sans JP",
      font: "Noto+Sans+JP",
      weight: 400,
      style: "normal",
    },
    {
      name: "Noto Sans JP",
      font: "Noto+Sans+JP:wght@700",
      weight: 700,
      style: "normal",
    },
    { name: "Noto Sans", font: "Noto+Sans", weight: 400, style: "normal" },
    {
      name: "Noto Sans",
      font: "Noto+Sans:wght@700",
      weight: 700,
      style: "normal",
    },
  ];
  // ...
}src/utils/loadGoogleFont.ts

查看更多信息请查看此 PR

权衡

虽然这是一个很好的功能,但也存在权衡。每张 OG 图片大约需要一秒钟生成。这在开始时可能不明显,但随着博客文章数量的增长,你可能想禁用此功能。由于每张 OG 图片都需要时间来生成,大量图片会线性地增加构建时间。

例如:如果一张 OG 图片需要一秒钟生成,那么 60 张图片将需要大约一分钟,而 600 张图片将需要大约 10 分钟。随着内容的扩展,这可能会显著影响构建时间。

相关问题:#428

局限性

在撰写本文时,Satori 还相当新,尚未达到主要版本发布。因此,这个动态 OG 图片功能仍然存在一些限制。


Share this post on:

Previous Post
如何在 Astro 博客文章中添加 LaTeX 公式
Next Post
如何将 Giscus 评论集成到 AstroPaper