配置Gridea客户端的踩雷全经历

决定不能让我的Github Pages闲着，毕竟放一些技术性文章在上面应该还是可以的，也能作为笔记方便日后遇上同样的问题后能及时找到解决方法。 群里有人推荐Gridea来做静态博客，我便搜了一搜，下载了客户端，确实很简洁，而且写文章很方便，主题也挺让我满意的，于是乎便动手试着连接到我的Github Page上。

远程连接与同步

配置部分由于官网有对应教程，在此不再赘述，在一切信息填写完毕后，显示无法远程连接，不论我怎么核对仓库名、用户名，或者换token都没有用，各路查找后，我打开了Edit→开发者工具→console，然后发现错误代码是“spawn git ENOENT ... at Process.ChildProces...ickCallbak”，解决方法就是在环境变量中编辑Path那一项，新建两条，分别包含你的计算机上安装的Git的bin目录和git-core目录，如下图所示：

编辑环境变量

这样配置完后重启Gridea客户端，便能成功远程连接了。 随后同步又出了问题，显示同步失败，请到FAQ或者联系作者解决（总算有了帮助界面，而且刚才远程连接的错误在里面就有却没有提示指引我去看那里），同样打开“Edit→开发者工具→console”，显示的异常如下图：

控制台异常

双击“message”便能看到所有报错信息，复制粘贴出来看就好（甚至可以复制到谷歌翻译上方便理解）：

信息详细

我这里出的问题是邮箱私有了，导致无法正确执行git命令，在github设置后，成功出现同步成功的字样。

同步成功

至此，基本功能得以实现。

gitalk评论系统的配置

想在博客里引入评论系统，我选择了Gitalk这个评论插件，Gridea只需要我们提供四个必须的东西，就能为站点添加好gitalk评论，我们需要去填的有Client ID、Client Secret、仓库和owner这四部分，其中Client ID和Client Secret需要我们去申请OAuth App，步骤如下： ①在Github右上角点自己的头像，点“setting”

点击设置

②点击“Developer settings”，点击“OAuth Apps”→“New OAuth Apps”

新建OAuth Apps

③到这个页面后，Application name随便填，Homepage URL填Github Page所在仓库的链接（https://github.com/用户名/仓库名…… 之类的），Application description可以不填，Authorization callback URL填你的Github Page的域名（区分http和https）

填写信息

④完成后复制Client ID和Client Secret到客户端，填好仓库和owner，就能使用gitalk评论插件啦！

若使用Coding Pages

经个人体验Coding Pages确实比Github Pages强很多。 注册和配置过程直接引入官方教程吧。 gitalk部分，OAuth App中需要修改的有两个部分，一个是Homepage URL，可以自己随便建一个仓库，填入仓库所在地址就行，一个是Authorization callback URL，需要填自己的Coding Pages的域名（区分http和https），然后Gridea中仓库一栏填自己OAuth App中用的仓库名，owner填建立仓库所用的Github账号的username。

除另有声明外，本博客文章均采用 知识共享(Creative Commons) 署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可，转载请注明文章出处。