利用GitHub和Gridea搭建个人博客

0x00 引言

使用GitHub pages服务器搭建博客的好处:

  1. 全是静态文件,访问速度快;
  2. 免费方便,不用花一分钱就可以搭建一个自由的个人博客,不需要服务器,不需要后台;
  3. 可以随意绑定自己的域名,不仔细看的话根本看不出来你的网站是基于GitHub的;
  4. 数据绝对安全,基于GitHub的版本管理,想恢复到哪个历史版本都可以;
  5. 博客内容可以轻松打包、转移、发布到其他平台。

0x01 准备工作

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,搭建博客

  1. 打开Gridea进入到配置页面,然后按照下面示例,输入相关配置并保存

在不开启文章评论的情况下,到此为止,你可以点击预览,点击同步进行博客部署了。

0x07 开启文章评论

Gridea目前提供了 GitalkDisqus 两种评论系统支持。

Gitalk 是一个基于 GitHub Issue 和 Preact 开发的评论插件。如果你博客使用的是 Gitalk 的话,建议你可以选择 Gitalk 来作为评论插件。

你可以按照 Gitalk 的文档 进行相关字段配置,或者按照下面的步骤操作。

首先你需要有一个 Github OAuth Application,点击 这里 创建,字段填写可以参照下图

创建完成之后可将 Client IDClient Secret 复制一下,保存到本地。

接下来就可以去应用里面填写对应的信息,并开启评论

这样评论插件就设置好了,在预览时会在文章页显示评论模块,但不会显示具体的评论信息,因为这个是本地预览,而 Github OAuth 设置的域名为线上的域名。待博客同步到线上时就可以显示啦!

参考

  1. 利用github和hexo搭建个人博客
  2. Gridea 小白上手教程