gatsby starter ghost

盖茨比入门幽灵

使用 Ghost & Gatsby 构建闪电般快速网站的入门模板

演示： https://gatsby.ghost.org/

安装中

 # With Gatsby CLI
gatsby new gatsby-starter-ghost https://github.com/TryGhost/gatsby-starter-ghost.git

 # From Source
git clone https://github.com/TryGhost/gatsby-starter-ghost.git
cd gatsby-starter-ghost

然后安装依赖项

yarn

跑步

启动开发服务器。您现在有一个 Gatsby 网站，从 Headless Ghost 中提取内容。

gatsby develop

默认情况下，启动器将从位于 https://gatsby.ghost.io 的默认 Ghost 安装中填充内容。

要使用您自己的安装，您需要使用您的凭据编辑.ghost.json配置文件。将apiUrl值更改为您的 Ghost 站点的 URL。对于 Ghost(Pro) 客户，这是以.ghost.io结尾的 Ghost URL，对于使用 Ghost 自托管版本的用户，它与用于访问您的网站的 URL 相同。

接下来，将contentApiKey值更新为与 Ghost 站点关联的密钥。可以通过在 Ghost Admin 中创建集成来提供密钥。导航到集成并单击“添加新集成”。适当地命名集成并单击“创建”。

最后，在siteConfig.js中配置您所需的 URL，以便正确生成链接（例如规范链接）。您还可以更新其他默认值，例如此文件中的postsPerPage 。

要毫无问题地使用此启动器，您的 Ghost 安装版本至少需要为2.10.0 。

用于此启动程序的默认 Ghost 版本是5.x 。如果您的 Ghost 安装版本较低，则需要在.ghost.json设置中传递version属性：

幽灵 >=2.10.0 <5.0.0

{
    "apiUrl" : " https://gatsby.ghost.io " ,
    "contentApiKey" : " 9cc5c67c358edfdd81455149d0 " ,
    "version" : " v4.0 "
}

幽灵 >=5.0.0

{
    "apiUrl" : " https://gatsby.ghost.io " ,
    "contentApiKey" : " 9cc5c67c358edfdd81455149d0 "
}

使用 Netlify 进行部署

Starter 包含三个专门用于使用 Netlify 进行部署的配置文件。用于构建设置的netlify.toml文件、为所有路由设置默认安全标头的/static/_headers文件以及用于设置 Netlify 自定义域重定向的/static/_redirects 。

要部署到您的 Netlify 帐户，请点击下面的按钮。

内容 API 密钥通常不被视为敏感信息，它们的存在是为了在滥用时可以更改；所以大多数人直接将其提交到他们的.ghost.json配置文件中。如果您希望将此信息保留在存储库之外，您可以删除此配置并为生产构建设置 Netlify ENV 变量。

部署后，您可以设置 Ghost + Netlify 集成，以使用 Ghost 中的部署挂钩来触发 Netlify 重建。这样，只要 Ghost 中的数据发生变化，您的站点就会在 Netlify 上重建。

优化

您可以通过在 Ghost 设置中启用Make this site private ”标志来禁用默认的 Ghost Handlebars 主题前端。这会在 Ghost 安装之前启用密码保护并设置<meta name="robots" content="noindex" />以便您的 Gatsby 前端成为 SEO 的真实来源。

额外选项

 # Run a production build, locally
gatsby build

# Serve a production build, locally
gatsby serve

Gatsby develop使用.ghost.json中的development配置 - 而 Gatsby build使用production配置。

版权与许可

版权所有 (c) 2013-2025 Ghost Foundation - 根据 MIT 许可发布。