相比于初版,博客已经经历了较大的改动。这份文档会尽量保持更新。
写在前面
gine-blog 使用 notion 作为博客后端,必须与 notion 搭配使用。在开始之前,确保您已经拥有 notion 账号。
你可以在 https://www.notion.so/gine/gine-blog-v1-60e00520137944a4a45a437c7d089488 上获取到,博客用到的所有表格模板。
你需要将上述页面 copy 到自己的 Notion workspace 中。然后你可以在页面中,修改站点配置、添加文章。
⚠确保模板页面是公开可访问状态,否则无法构建成功!
快速体验
无需关心代码,访问
https://app.netlify.com/start/deploy?repository=https://github.com/mayneyao/gatsby-starter-gine-blog
按照提示操作,即可部署一个与此博客相同的站点。在你的 Github 账号下,会出现一个名叫 gatsby-starter-gine-blog
的仓库。
修改基本配置
修改 gatsby-starter-gine-blog
仓库中的 gatsby-config.js
文件。
module.exports = {
plugins: [
{
resolve: `gatsby-theme-gine-blog`,
options: {
configTable: "这个链接改为模板页面中 SiteConfig 表格的 URL"
}
},
{
resolve: `gatsby-source-notion-database`,
options: {
configTable: "这个链接改为模板页面中 SourceConfig 表格的 URL"
}
}
],
}
gine-blog 会从 SiteConfig
表格中获取站点配置(站点名称、描述、是否开启某项功能等),从 SourceConfig
表格中配置的数据源获取数据(文章、友链、动态等)
发布自己的文章
在 Source Table - posts
表格中添加新文章,写作然后将 status 字段设置为 published
,发布状态的文章都需要设置公布时间,public_data 需要自己手工设置,否则会构建失败。
在 Netlify 中重新构建博客,构建完毕后即可看到自己新发布的文章。如果你不想进入 Netlify 网站点击部署。可以通过 build hook 触发构建。 Netlify 提供了 build hook,配置 hook 后,向给定的地址发送请求,即可触发站点构建。
- iOS 上通过捷径发送 build 请求
- Android 上可以通过 IFTTT发送 build 请求
配置项说明
站点配置表格中已经有关于配置的注释,你可以参考注释和样例自行修改,此处不再赘述。
博客结构组成
- gatsby-starter-gine-blog
starter 可以帮助用户快速构建站点。完成上述操作后,用户 Github 账号下会创建一个同名的仓库。用户可以修改此仓库,重载主题,添加新功能,跟进主题更新。
https://github.com/mayneyao/gatsby-starter-gine-blog
- gatsby-theme-gine-blog
主题插件。gine-blog 主题仓库,如果你熟悉 Gatsby 开发,可以自己写新的主题。
https://github.com/mayneyao/gine-blog
- gatsby-source-notion-database 数据处理
数据源插件。将 notion database 中的数据,转化为 Gatsby 中可用的 Graphql 数据。
https://github.com/mayneyao/gatsby-source-notion-database
如何更新
gine-blog 目前尚未稳定,存在 bug 或者性能问题。用户在使用过程中有任何问题,可以在 gine-blog 仓库下提 issues,修复后 gine-blog 主题会发布新版本。
用户需要修改 gatsby-starter-gine-blog
仓库中的 package.json
文件。修改 gatsby-theme-gine-blog
的版本号即可完成更新。