Gatsby + TinaCMS 设置指南

介绍

TinaCMS 可以本地添加到您的 Gatsby 网站。在本文档中,我们将指导您完成本地设置,以及在生产网站上的编辑。

您可以参考我们的 TinaCMS Gatsby Starter 作为示例。

入门

在您网站的目录中运行:

这将询问您一些设置问题。

当被询问“公共资产目录”时,输入:static

如果您是从 Forestry.io CMS 导入您的网站,某些模型和配置将被自动导入。

GraphQL 不匹配问题的解决方法

对于 Gatsby 网站,您可能会遇到以下错误:

为了解决这个问题,请将以下几行添加到您的 package.json 文件中。

这样您可以强制使用 TinaCMS 所需的 graphql 版本。

为确保您需要哪个版本,您可以在项目文件夹中运行 npm list graphql

在开发模式下允许静态 /admin/index.html 文件

为了在开发模式下使 TinaCMS 管理界面可访问,您需要将以下代码添加到您的 gatsby-node.ts 文件中。

建模您的内容

要在 TinaCMS 中编辑您网站的内容,您可以在 tina/config.ts 文件中建模您的内容。

了解更多关于内容建模的信息

启动 TinaCMS

您可以通过以下命令启动 TinaCMS:

gatsby develop 可以替换为您网站的自定义开发命令。

在 TinaCMS 运行时,导航到 http://localhost:8000/admin/index.html

^ 上述默认端口可能会根据您的框架而有所不同。
提示:一个常见错误是运行 gatsby clean tinacms build 之后。这会导致您的管理 html 文件被清除。有关更多常见错误,请参阅 常见错误 页面。

此时,您应该能够看到 TinaCMS 管理界面,选择一个帖子,保存更改,并看到更改持久化到您的本地 markdown 文件中。

设置可视化编辑(可选)

如果您希望使用 TinaCMS 的 API 为您的页面提供支持,您将能够利用 TinaCMS 的可视化编辑功能。

阅读更多关于数据获取可视化编辑的信息。

注意:使用 Gatsby 的可视化编辑被认为是实验性的。

下一步

另请参阅

Last Edited: October 21, 2025