Gridea

定义

Gridea 是一款运行在个人电脑上的静态博客写作客户端，定位是让使用者在图形界面中完成博客的写作、管理与发布，而不必自行配置命令行构建流程^[2]。它面向的是希望拥有独立站点、但不愿深入学习前端工程与部署脚本的使用者^[5]。

按软件类别划分，Gridea 属于静态站点生成器与内容管理工具的交叉形态：它本身不提供服务器端的动态渲染，而是把文章编译为静态文件后交给外部托管平台^[3]。其描述文件中把自身概括为「静态博客写作客户端」。

原理

Gridea 的客户端以 Electron 与 Vue.js 构建，属于桌面端应用，可运行于 Windows、macOS 与 Linux^[6]。使用者指定的源文件夹用于保存 Markdown 文稿、站点配置和主题文件，客户端读取这些内容后按主题模板渲染，输出到构建目录^[7]。

同步环节借助 Git 完成。早期版本要求使用者在本机安装并可在命令行调用 git，客户端把构建结果提交并推送到远端仓库^[3]。使用者在设置中填写域名、仓库名、分支、用户名、邮箱以及用于推送的访问令牌，并通过「检测远程链接」验证配置是否可用。

站点内容本身由 Markdown 标记书写，客户端提供语法快捷操作、实时预览、封面图与标签设置，并支持数学公式渲染。渲染产物是纯静态的 HTML、样式与脚本文件，因此访客访问时不需要后端程序参与^[8]。

发展历程

Gridea 的前身名为 Hve Notes，同样被描述为一款静态博客写作客户端，由 Vue.js 与 Electron 开发，作者为 EryouHao。项目在 2019 年前后更名为 Gridea，更名原因与名称更易读、更易记有关。

2019 年 4 月，项目发布 0.8.0 版本^[9]。此后陆续更新至 0.9.x 系列，其中 0.9.0、0.9.1、0.9.2、0.9.3 等版本均有对应的安装包记录^[10]。0.9.3 版本于 2022 年 5 月 17 日发布，该版本把构建输出目录调整到用户主目录下的隐藏文件夹，与站点源文件夹分离，并改为只保留最近一次同步的提交记录^[11]。

0.9.3 之后原版长时间没有新版本，第三方软件收录站点的记录显示其在此后十几个月内没有发布更新^[12]。社区随后以 Gridea Pro 的名义基于原项目进行了重写，改用 Go、Wails 与 Vue 3 构建，并延续原有的写作客户端定位^[4]。

应用

Gridea 的主要用途是搭建并维护个人博客或其它静态站点。使用者在本机写好文章后，通过同步操作把构建结果推送到托管平台，常见的发布去向包括 GitHub Pages、Coding Pages 以及通过 SFTP 上传到自建服务器^[5]。

在站点组织方面，客户端提供标签分组、自定义导航菜单、外部链接菜单以及多套内置主题的选择，也可以载入第三方主题^[3]。评论功能通过接入 Gitalk 或 DisqusJS 等第三方评论组件实现。

数据存放在本地源文件夹，使用者可以配合 OneDrive、iCloud、Dropbox 等网盘同步工具，在多台设备之间备份和同步博客源文件^[7]。这一特性也常被用于只把源文件保存在本地、需要时再同步到远端的场景^[8]。

局限

Gridea 产出的站点是静态站点，页面在访客访问前已生成完毕，因此不包含需要服务端执行的动态功能^[8]。评论、访问统计等交互能力需要借助外部第三方服务接入，客户端自身不提供这些服务。

作为面向个人写作者的轻量工具，它提供的功能相对有限，站点数据的维护与备份需要使用者自行负责^[5]。早期版本的同步依赖本机已安装的 Git 程序，环境不具备该条件时无法完成推送^[3]。

在内容迁移方面也存在限制：从 Hexo 导入的文章会丢失分类信息，因为该客户端只保留了标签这一种内容分组概念^[7]。此外，原版项目在 0.9.3 版本之后长期未继续维护，使用者若需要新特性或新的运行时支持，只能转向社区重写的分支版本^[4]。

参见

• 静态网站生成器 —— Gridea 产出的站点属于此类工具的构建结果

• Markdown —— Gridea 撰写文章所使用的主要标记语言

• GitHub Pages —— Gridea 常用的静态站点托管平台之一

• Electron —— 原版 Gridea 客户端所采用的桌面应用框架

• Hugo —— 另一款面向开发者、通过命令行使用的静态站点生成工具

• 版本控制 —— 客户端同步与推送博客文件所依托的机制