前言
最近重新思考了一下大层面上的东西，觉得在人世间活过一遭总归是要留下些什么，如果更好的是能够带去些什么。
之前有写过hexo建站，但是hexo的不稳定性以及频繁的hexo d hexo g手动命令操作使我厌烦。机缘巧合之中，在知乎上看到了一款快速建站软件。
它体积量很小，也很年轻，除了主题外配置都是一个人在维护，但是现在看来总体运行情况十分稳定。我承蒙了该软件的好处，写下这篇新人向的快速建站手册，希望能够帮助到有同样想法的人。
这是我的博客地址，欢迎来玩：Giria's Blog
简单介绍
Gridea 最早叫 Hve Notes ，开发者为了更易读和好记，重新命名为 Gridea ，支持 Windows 和 Mac 平台，它的基础界面非常地小清新。
只需要简单配置，便可图形化可交互地进行博文上传同步、主题更改等操作。这些后面都会详细介绍，包括一些踩坑向。
软件安装与配置
Git安装
这块不用多说，写的比我详细的大有人去， Git官网下载平台对应的安装程序。安装没有特别的要求，一路下一步即可。
如果遇到问题谷歌would help you
Gridea安装
Gridea官网下载对应平台的安装程序进行安装。
初始配置
这里搬出官网文档：gridea.dev/gridea-star…
github pages仓库创建与开通
-
首先，需要创建一个仓库，建议仓库为 username.github.io。根据[官方文档](zhuanlan.zhihu.com/p/71681116/… 帮助)， GitHub 会默认将名称符合要求的仓库设置成 GitHub Pages 可访问类型。例如我的用户名是 giriawsh，仓库名便为giriawsh.github.io
-
创建成功后来到项目仓库的settings
-
找到 GitHub Pages 设置的地方 点击 Choose a theme 随意选择一个主题。因为后续我们使用 Gridea 设置主题，这边选择主题只是为了开启 GitHub Pages 可访问类型。（不然po不上去）
创建访问token
这块官方文档里有：
Gridea 管理 GitHub Pages 需要 token。登录 GitHub 后点击这里 创建一个新的 token。
勾选上 repo 相关权限即可。
生成之后记得把 Token 复制到你的本地，因为一旦关闭网页将不能再看到它。
Gridea配置
进入 Gridea 进行远程设置。按照下图的示例进行设置，然后点击「检测远程链接」，进行配置检查。
- 域名：Github Pages 对应的域名
- 仓库：你的静态文件存放的仓库
- 分支：你的 Github Pages 对应的分支（例如：master）
- 用户名：仓库所属用户的用户名（通常就是你的 Github 账号的昵称）
- 邮箱：Git 推送时使用的邮箱（通常就是你的 Github 账号的邮箱）
- Token: Git 推送时需要的 Token，用来向 Github 提交构建后的文件 Github personal access tokens
- CNAME: 可通过这个选项配置你自己的域名
出现错误可能原因：
- 域名未填对，如果https的域名不行改用http
- 仓库名错误
- Token在开头多加了一个空格（复制的锅）
同步。点击 Gridea 中的 同步按钮即可。初次部署等待几分钟之后就可以去浏览器访问了（也有可能是半小时），默认地址为你在第 3 步所填写的域名。
Godaddy域名配置
如果想要拥有自己独一无二又好记的域名，可以到godaddy网站上进行域名购买。如果在国内购买需要去登记下。
选择自己喜欢的（注意一下续费年费），用支付宝买下就OK
然后在“我的产品”中找到购买的域名：
点击DNS，进入配置界面
在记录中增加两条记录：
（注意把giriawsh替换成自己的用户名）
A类型的值可以通过
ping <your username>.github.io
获得。
接着打开gridea，将CNAME设置为你的域名。
同步后github仓库中便可以看到CNAME已经做了同步修改，同时也出现了网站已被同步po到新域名的样式。再等全球服务器缓冲一会儿，你的域名就可以被访问了。等待一段时间后，可开启Enforce HTTPS选项。
Gitalk评论配置
Gridea 支持 Gitalk 和 Disqus 两种评论系统，这里我使用 Gitalk 评论系统。
首先你需要有一个 GitHub OAuth Applicatio ，点击这里创建。这里我用到另一个博主的图片：
创建完成后可将 Client ID 和 Client Secret 复制保存到本地。
打开Gridea-远程-评论配置，粘贴
设置、保存并同步后评论模块就可用了。
踩坑
开始配置完成后，虽然文章末尾已经显示评论界面，但是只要我一点击登录评论，就会跳转到首页。这个情况常常发生在有自己域名的博主身上，我把Authorization callback URL中的www去掉就可以正常登陆了（原理不知）如下图所示：
效果如下：
主题配置
本站使用的是由SERENCE改版的pro版。
在此基础上做了一些个人向的修改。再次感谢大佬的卓越贡献，已star。
从网站下载zip包后，把 bitcron-pro 文件夹放入 ~/Gridea/themes 【默认文件夹】或者手动修改过的网站源文件文件夹中，解压缩，重启Gridea即可。
更多主题可查看官方给出的主题超市：gridea.dev/themes/
踩坑
- 如果创建了新标签，记得及时给文章引用上，不然会无法po文
- gridea中无category的概念，如果需要，可以在菜单栏中链接到某个网页或者某个标签
- 一次性po文太多可能导致一些奇怪bug
- 不要在标题中使用~等特殊符号
参考致谢
Gridea 上手教程——小白也可以用的 GitHub Pages 搭建工具
在Gridea中配置Gitalk评论系统 -> 这个博主的主题很好看，不知是源于什么自改的？
