将 TinaCMS 添加到现有站点

注意:本文档假设您已经有一个正在运行的站点。如果没有,您可以快速开始使用我们的默认 Astro starter 或 CLI 中的 其他启动器

添加 TinaCMS

我们创建了一种快速引导 TinaCMS 应用程序的方法,以展示可视化编辑的强大功能;在终端中输入以下命令:

有关非 NextJS 站点的提示帮助,请参阅本指南

此命令将询问您几个问题,并在您的应用程序中设置 TinaCMS 样板:

  1. 安装 TinaCMS 所需的所有依赖项。
  2. tina 目录中定义一个基本的内容架构。
  3. 在 demo 目录中创建示例内容。
  4. (仅限 NextJS):编辑 package.json 以使 devbuildstart 脚本运行 tina GraphQL API。

更新您的构建脚本

根据您的框架,tina init 可能会尝试更新您的 package.json 脚本。

NextJS 示例

Hugo 示例

如果 CLI 没有设置这些,您需要手动应用。

快速测试

现在我们已经设置了一个基本的 TinaCMS 样板,您可以使用以下命令启动您的应用程序:

当 TinaCMS 在 NextJS 站点上初始化时,会创建一个 "/admin/index.html" 页面,以允许编辑者登录并开始进行内容更改。

现在,如果您导航到 http://localhost:3000/admin/index.html(假设您的站点运行在端口 3000 上),您应该会看到一个新的 CMS 登陆页面已添加到您的站点!

提交 tina-lock.json 文件

<strong>重要:</strong> 运行 <code>tinacms dev</code>(或 <code>yarn dev</code> 如果您的开发脚本包含它)会生成一个 <code>tina/tina-lock.json</code> 文件。这个文件 <strong>必须提交并推送到您的仓库</strong>,以便 TinaCloud 索引您的内容和分支。没有它,TinaCloud 将无法检测到您的架构,您的分支将保持未索引状态。

首次运行您的开发命令后,请确保提交并推送生成的 tina/tina-lock.json

注意,许多框架提供了一种将 /admin/index.html 重定向到 /admin 的方法。

Figure: TinaCMS 在 /admin 的登录界面

接下来,我们将向您展示如何使用 CMS 并开始编辑一些内容!

Last Edited: February 4, 2022