整合 Obsidian、Hexo 与 Gitea Actions

  • ~1.91K 字
  1. 1. 整合思路
  2. 2. 目录划分
  3. 3. 内容与附件整理
  4. 4. 写作与同步
  5. 5. 自动检查与发布
  6. 6. 参考资料

过去的文章和笔记分别保存在 Hexo 与 Obsidian 中,写作、附件管理和发布需要来回切换。借着 Kratos Rebirth 主题升级,我将它们整合到同一个 Git 仓库:在 Obsidian 中写作,用 Hexo 生成博客,通过 Gitea Actions 完成检查与发布。

这次整合没有改变 Hexo 的基本使用方式,主要是统一内容入口,并把私人笔记与博客文章的发布范围分开。

整合思路

三个工具各自负责一件事:

  • Obsidian:写文章、整理笔记和管理附件。
  • Hexo:读取博客文章,生成静态网站。
  • Gitea Actions:检查构建结果,将生成的网站上传到服务器。

Git 保存整个项目,包括私人笔记;网站发布只上传 Hexo 生成的 public/。因此,“需要同步的内容”和“允许公开的内容”可以放在同一个仓库中,分别管理。

目录划分

在 Hexo 项目中建立 vault/,作为唯一的 Obsidian 保险库:

hexo-blog/
├── source/
│   ├── _posts -> ../vault/blog/posts
│   └── images/             # 站点通用图片
├── vault/
│   ├── blog/posts/         # 博客文章与文章附件
│   ├── notes/              # 私人笔记
│   ├── attachments/        # 私人附件
│   ├── template/           # 写作模板
│   └── .obsidian/          # Obsidian 设置
└── .gitea/workflows/       # 构建与发布流程

在 Obsidian 中打开 vault/,Hexo 命令仍在项目根目录执行。

博客文章统一保存在 vault/blog/posts/,由 source/_posts 的符号链接接入 Hexo,避免维护两份文章。私人笔记和附件保存在另外两个目录中,通过 Git 同步,但不链接或复制到 source/,也不随网站部署。

内容与附件整理

迁移时先备份原有内容,再将 Hexo 文章和 Obsidian 笔记按用途归类。原文章的 Front Matter、发布日期和目录层级尽量保留,减少对已有网址的影响。

博客附件放在文章旁的同名目录,使用标准 Markdown 相对路径引用,兼顾 Obsidian 预览和 Hexo 发布。例如:

技术笔记/
├── 示例文章.md
└── 示例文章/
    └── 截图.png

文章中写:

![截图](示例文章/截图.png)

本项目通过 Hexo 的文章资源目录配置和独立扩展处理发布路径。私人附件仍留在 vault/attachments/,站点通用图片放在 source/images/。

写作与同步

通过 QuickAdd 和 Templater 提供三个新建入口:普通博客、加密博客和私人笔记。模板负责填写文章头信息,减少重复输入;文章参数和标签组件遵循 Kratos Rebirth 官方文档。

普通博客可以公开发布,非空密码的博客会加密正文;完全不发布的内容放在私人笔记目录。加密博客仍属于网站内容,源文件、密码和附件也不能因此当作已经保密。

Obsidian 的共享设置、社区插件清单和经过检查的白名单插件配置纳入 Git;插件程序、缓存、日志和工作区状态留在本机。换电脑后仍需安装插件,插件清单不会自动完成安装。

多台电脑交替使用时,先在原电脑提交推送,再在另一台拉取后继续编辑。保持一个明确的同步入口,避免 Git 与其他同步工具同时修改同一批文件。

自动检查与发布

Gitea Actions 分为构建检查和正式发布两部分:

  • 日常推送:文章、附件或构建配置发生变化时,安装依赖并执行 Hexo 构建检查;仅修改私人笔记时不触发。
  • 正式发布:推送 v 开头的标签,或手动运行发布工作流,构建完成后保存站点产物,再通过 FTP 上传 public/。

构建过程中会检查私人目录是否进入发布路由、加密文章是否正常处理,以及生成页面中的本地图片是否存在。正式发布保留站点产物,便于上传失败后重试,或恢复之前的版本。

这样,日常笔记同步与网站上线可以分开进行,写完内容也可以先预览、检查,再决定何时发布。

参考资料