将 TinaCMS 添加到现有站点
注意:本文档假设您已经有一个正在运行的站点。如果没有,您可以快速开始使用我们的默认 Astro starter 或 CLI 中的 其他启动器。
添加 TinaCMS
我们创建了一种快速引导 TinaCMS 应用程序的方法,以展示可视化编辑的强大功能;在终端中输入以下命令:
有关非 NextJS 站点的提示帮助,请参阅本指南。
此命令将询问您几个问题,并在您的应用程序中设置 TinaCMS 样板:
- 安装 TinaCMS 所需的所有依赖项。
- 在
tina目录中定义一个基本的内容架构。 - 在 demo 目录中创建示例内容。
- (仅限 NextJS):编辑
package.json以使dev、build和start脚本运行 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 并开始编辑一些内容!