Gridea 安装及多设备管理指南
Gridea 安装避坑指南
2023-11-01 更新：建议先看的内容
关于 Gridea 的适用人群
有博客写作需求，并且有能力解决 GitHub 的访问问题（这是必要条件），否则，不建议使用以下任何一种方式来尝试用 Gridea 维护博客，或许你可以尝试一下作者的付费软件。
10 月以来我设置 Gridea 的简要过程记录：
Gridea 在 2023 年 10 月 10 日我更新博客时出现问题，由于距离上次更新已时隔三月，我不能确定问题出现在哪里，依据我首次设置的经验，我判定我可以很快解决问题，但事实并不如此。在花费一个晚上一个上午，并且还做了一晚上有关设置的梦严重影响睡眠之后，我终于在办公室的电脑上又一次同步成功，并且将博客源文件从 OneDrive 换到了单位的 NAS 上，谁曾想在家里的电脑上 GitHub Desktop 又出了问题，一时间我产生了想放弃、不想再去解决这个问题的想法。
谁曾想我又一次做了关于解决同步问题的梦，并且还那么真切，于是在今早到达办公室后我决定再尝试一次。起初还是用之前的方法，打算借助 GitHub Desktop 来同步，可问题依旧。
我去看了作者发布的设置视频，瞄了几眼网友的留言。我按着步骤设置了新的 token，然后进行远程测试，之后点了同步，没曾想，它竟然同步成功了，于是我想到「或许保持网络畅通，就可以用本体来进行同步」。随后我将问题聚焦在了保持网络畅通上，试过几次之后我知道只要设置好代理并保持网络畅通，大概率就会同步成功。
目前我使用 v0.9.3（下载地址），并将源文件放在了《坚果云》上面，不管是在办公室还是在家里，都已经可以成功同步。
老方法
以下内容依然成立，只不过不是我的第一选择。
注：此指南适用于 v0.9.2（使用 v0.9.3 不能成功发布）。
之前我维护过一个使用 Hexo 驱动的博客，后来进行公众号一百天日更，博客的维护就落下了。最近在浏览 软通达 博客时发现了 Gridea 这个静态博客写作客户端，遂进行尝试。
官方的文档很简单，也很容易理解，但实际设置会发现里面有不少坑，折腾期间我甚至想过干脆用回 Hexo 得了（事后明白，与 Gridea 相比，Hexo 的维护门槛要更高）。
为方便自己之后维护，同时方便他人参考，下面我将过程做详细记录，并列明参考材料。
安装及初步设置
从 https://github.com/getgridea/gridea/releases 下载 v0.9.2 版本。GitHub 不稳定，这里我给大家提供一个方便下载的安装包：下载链接
详细安装及配置 GitHub Pages 流程可以查看 Gridea 官方文档中的 🤗 快速上手。在这里大家需要注意，「快速上手」中「发布」的第 3 步，分支需要填 main，而不是 master。
2022-12-05 更新：关于 Token 更新
2022 年 12 月 5 日，我在更新博客时发现仓库无法更新，搜了一圈才隐约想起可能是 Token 到期，于是到 GitHub 检查，发现之前设置的 Token 已经于 2022 年 11 月 26 日到期，需要进行更新。
以下是我的操作方法：
进入 Token 设置页面，按照 Gridea 官方文档中的 🤗 快速上手 设置新的 Token，然后复制 Token 贴到 Gridea 的 令牌 即可。如果你是多设备，请记得保存 Token，因为关了页面就再也看不到了。
这次我还是设置了 1 个月的有效期，下次可能我会设置更长的时间，为了避免又出现今天这样的情况，我在手机上设置了提醒闹钟。
2023-01-31 更新：关于 Token 更新的补充
我的 Token 又到期了，提醒闹钟也没看到，不过我发现了更快更新 Token 的方法。
首先进入 Token 设置页面，在这里我们能看到我们所有的 Token 列表。
如果过期了它会提示你更新（上图展示的就是一个过期的 Token，点击红框圈住的位置会出现下图〔2023-05-09 更新〕），选择想延长的日期进行更新。
然后就会获得新的令牌，复制填写到令牌位置即可。
⚠需要注意保存，因为关闭页面就再也看不到了。
2023-10-10 更新：关于 Gridea 令牌更新
切记在 Gridea 的 远程 选项卡更新令牌后一定要记得点右下角的 保存，不然 GitHub Desktop 会报错。
解决无法同步问题
还是那句话，我们访问 GitHub 并不稳定，因此使用软件自带的同步极大可能不成功，如果同步不成功可以采用以下办法解决。注：该过程可能会用到代理，此处不展开。
以下内容摘自 解决Gridea同步失败的问题 | gd1214b's blog （永久链接）。
1. 连上代理，安装 GitHub Desktop
打开安装程序即可自动完成安装。
2. 在 GitHub Desktop 中登录你的账号
此步旨在将 GitHub Desktop 连上 GitHub。
3. 清空 Gridea 配置目录下 output 文件夹里的所有内容
清空 ouput 文件夹所有内容的原因是 GitHub Desktop 无法克隆仓库到非空文件夹中，这一步不会影响你的博客数据。
4. 在 GitHub Desktop 中克隆你的博客仓库
注意目录要选择 Gridea 配置目录下的 output 文件夹，你在选择克隆路径的时候，GitHub Desktop 会把你的 GitHub 仓库名称（如「wanghusw.github.io」)也设置为路径，所以你要把路径（如 …\Gridea\output）中「output」后面的内容都删掉，即最终的路径应该为 …\Gridea\output，这样克隆的仓库就会到 output 文件夹了。
5. 同步 Gridea
在 Gridea 中依次点击 远程 > 检测远程连接 > 同步，这一步无所谓是否同步成功。
6. 将博文同步到 GitHub 上
你都要发布了，那肯定有 change files，先点击左下角的 Commit，再点击右边的 Push origin。
完成后等待一会儿，你的博文内容就会出现在你的网站了。可以看看我的： Wang Hu's Blog 。
多设备管理
很简单，就是将博客源文件夹（默认是 …\Documents\Gridea）通过 OneDrive 或 坚果云（其他同步盘不推荐）进行同步。然后再在另一台设备上进行上面的设置就好了。
Enjoy~😜