利用GitHub和Gridea搭建个人博客
0x00 引言
使用GitHub pages服务器搭建博客的好处:
- 全是静态文件,访问速度快;
- 免费方便,不用花一分钱就可以搭建一个自由的个人博客,不需要服务器,不需要后台;
- 可以随意绑定自己的域名,不仔细看的话根本看不出来你的网站是基于GitHub的;
- 数据绝对安全,基于GitHub的版本管理,想恢复到哪个历史版本都可以;
- 博客内容可以轻松打包、转移、发布到其他平台。
0x01 准备工作
- 有一个GitHub账号,没有的话去注册一个;
- 安装了 git for Windows(或者其他git客户端)
- 安装了 Gridea 客户端
0x02 GitHub创建个人仓库
1、 新建一个GitHub仓库,命令规则为 你的用户名.github.io
(必须是你的用户名,其他名称无效),比如我的用户名是 W-Peter
,那么就新建 W-Peter.github.io
的仓库,将来我的博客访问地址就是 https://W-Peter.gitub.io
0x03 安装 Git
从 Git 官网下载 Git,下载安装后在命令行里输入 git --version
测试是否安装成功。
0x04 安装 Gridea
从 Gridea 官网 下载Grande,下载之后,一路默认安装即可。
0x05 获取GitHub Token
前面步骤已经注册过GitHub账号,登录GitHub,然后进入到 这里创建一个 Token,勾选上 repo的相关选项即可,下面是对应的截图
示例:
生成之后你可以复制 Token到你可以再次找到的某个地方,因为一旦你关了这个网页就再也不会看到它了,这个 Token会在Gridea软件中使用
0x06 配置Gridea,搭建博客
- 打开Gridea进入到配置页面,然后按照下面示例,输入相关配置并保存
在不开启文章评论的情况下,到此为止,你可以点击预览,点击同步进行博客部署了。
0x07 开启文章评论
Gridea目前提供了 Gitalk 和 Disqus 两种评论系统支持。
Gitalk 是一个基于 GitHub Issue 和 Preact 开发的评论插件。如果你博客使用的是 Gitalk 的话,建议你可以选择 Gitalk 来作为评论插件。
你可以按照 Gitalk 的文档 进行相关字段配置,或者按照下面的步骤操作。
首先你需要有一个 Github OAuth Application,点击 这里 创建,字段填写可以参照下图
创建完成之后可将 Client ID 和 Client Secret 复制一下,保存到本地。
接下来就可以去应用里面填写对应的信息,并开启评论
这样评论插件就设置好了,在预览时会在文章页显示评论模块,但不会显示具体的评论信息,因为这个是本地预览,而 Github OAuth 设置的域名为线上的域名。待博客同步到线上时就可以显示啦!