Skip to content

Commit

Permalink
Update docs/pages/zh-CN/integrations/vitepress-plugin-og-image/index.md
Browse files Browse the repository at this point in the history
更加详细的说明了如何使用社交卡片插件。

Co-authored-by: Neko Ayaka <[email protected]>
  • Loading branch information
Dolyn157 and nekomeowww authored Jul 11, 2024
1 parent bcc0e09 commit 2e6d57d
Showing 1 changed file with 23 additions and 1 deletion.
24 changes: 23 additions & 1 deletion docs/pages/zh-CN/integrations/vitepress-plugin-og-image/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,4 +38,26 @@ yarn add @nolebase/vitepress-plugin-og-image -D

### 为我的项目自定义的社交卡片

本插件采用可缩放向量图形(svg)格式的模版为博文页面提供社交卡片功能。如果你希望使用自己设计的社交卡片,需要将你自定义的社交卡片模版命名为 `og-template.svg` 并将其放置在项目根目录下的 `public` 目录里。如果插件在 `public` 目录中找不到 `og-template.svg` 文件,则会使用插件自带的模版为博文页面生成社交卡片。
本插件采用 SVG 格式的模版为每个页面提供社交卡片(也叫做 OpenGraph image,通常在 Meta,X,Discord 发送链接时会被展示成一个图片卡片,你可以在 [Nuxt SEO Og image Examples](https://nuxtseo.com/og-image/getting-started/examples) 了解更多内容)的功能。

要使用 `buildEndGenerateOpenGraphImages`,您需要两样东西:

为实际部署的网站指定 `baseUrl`

默认情况下,`@nolebase/vitepress-plugin-og-image` 会尝试搜索 [`/public` 目录](https://vitepress.dev/guide/asset-handling#the-public-directory) 下的 `og-template.svg` 文件,以渲染社交卡片图片。在构建模板的时候,需要注意,`@nolebase/vitepress-plugin-og-image` 插件将使用

- `{{category}}`
- `{{site_name}}`
- `{{site_description})`

预览标题:

- `{{line1}}`
- `{{line2}}`
- `{{line3}}`

作为模板变量。(很抱歉设计得不好,但我还没想出更好的主意来为用户和开发人员设计出足够灵活的东西,欢迎大家提出意见来和我一起改进它。)

如果你希望使用自己设计的社交卡片图片,可以使用 Figma、Adobe Illustrator 制作包含上述内容的文件,需要将你自定义的社交卡片图片模版命名为 `og-template.svg`,并将其放置在 VitePress 项目根目录下的 [`/public` 目录](https://vitepress.dev/guide/asset-handling#the-public-directory) 目录里。

当然,如果没有准备模板也不用担心无法使用这个插件,如果插件在 `public` 目录中找不到 `og-template.svg` 文件,则会使用插件自带的模版为页面生成社交卡片的图片。

0 comments on commit 2e6d57d

Please sign in to comment.