简悦 + Logseq + Github Page 无代码全自动化知识管理发布方案

[Kenshin]

在简悦标注，自动生成符合 Logseq 的标注文件，然后发布到 Github Page 的无代码化全自动方案。

感谢

@tiensonqin 提供了这么棒的双链笔记 Logseq，得益于 @pengx17 发布的 Logseq Publish GitHub Action，可以非常方便的使用 Logseq 编写，使用 Git 发布它。

流程

整个工作流包含两种方案

1. 当你在 Logseq 页面的任何改动都会自动发布到你的 Github Page 上面， 你看到的 这篇教程 就是此方式发布的。

Logseq.Github.Page.mp4

2. 在简悦中的任意标注都会发布到你的 Github Page 上面

在 Web 端使用简悦标注，并通过简悦的同步助手自动将以 Markdown 形式的标注导入到 Logseq page 文件夹，并使用 Hazel（或 crontab ）自动 Push 到 Github repo 后通过 Logseq Publish GitHub Action 自动发布的全流程无代码自动化发布方案。

Github.Page.mp4

为什么是 Logseq

• Logseq 支持 outliner 层级结构，类似 Workflowy / Roam Research 的效果，每层都可以延伸为一个「新的 Page」，非常适合「知识的生长」。

• 虽然 Obsidian Publish 也提供发布功能，但定制化程度不如 Logseq 且只能 Host 在它的服务器上面。

• 基于 Local first，因此非常适合跟简悦搭配一起做知识管理。

平台

• 简悦（含同步助手）

• Logseq

• Github Page + Logseq Publish GitHub Action

配置

关于 Github Page + Logseq + Logseq Publish GitHub Action 的配置。

简单配置

• Clone https://github.com/23784148/knowledge-garden 到本地。

• 设置你的 Logseq 到此文件夹。

• Push 到你的 Repo & 设置 Github Page。

详细配置

下面的内容是详细配置，方便你理解整个配置过程。

• 建立 一个新的 Public repo

  

• 打开 Logseq Publish GitHub Action 并复制 main.yaml 里面的内容，然后在上一步建立的 repo 下建立一个新的 Action。

  

  （将上步得到的内容）粘贴其中，按下图所示操作，然后点击 Start commit 后不用更改其它内容，直接选择 Commit new file 即可。

  

• 将 Logseq 库文件设置到（ Clone 后的）文件夹。
  

  如果设置无误的话此文件夹应该是下图所示的文件结构。

  

• 设置主题和样式，为便捷使用，我直接将下面的文件复制

  • custom.css 复制到 logseq 里面。

  • [logseq dev theme.md](https://github.com/23784148/knowledge-garden/blob/main/pages/logseq dev theme.md) 复制到 pages 里面。

  • config.edn 复制到 logseq 里面。

  打开 Logseq 并进入 logseq dev theme 后会看到如下的截图内容，说明样式设置成功。

  

• 将全部文件提交到 Github，当提交后会自动进行 Actions 操作，会有下图所示的效果。

  

  进入 Settings → Pages，并按下图所示选择，设置 gh-pages 为 Github Page 分支，然后点击 Save。

  

  然后回到 Actions，如果出现下图所示的效果说明配置成功。

  

  回到 Page 页面，根据截图所示访问你的 Github Page

  

• 访问 <上图所示的地址>#/page/logseq dev theme 比如这个教程 所示的例子 会得到下图所示的内容，则说明配置成功。
  

自动化

当 page 文件夹有改动时，自动 Push Github。

Hazel

自动化方案选择是 Hazel 这个监控文件夹变化而进行一系列自动化操作的 Mac App，如果你是 Windows 用户可以使用 Dropit。

（对上图）简单的说明

• 除了监控 page 文件夹外也可以是其它文件夹 e.g. journals logseq assets 甚至于监控根目录的 README.md（当此文件改动时再提交)。

• 为了降低执行的频率，文件改动一分钟后再执行，这里的数字可以改为任意值。

• Shell 代码很简单，就是 Push 到 Github

    cd /<your path>/knowledge-garden
    git add .
    git commit -m "auto save:Update some logseq pages."
    git push origin main
  

crontab

如果你没有 Hazel 的话，也可以使用 crontab 方案，也就是每隔 xxx 时间自动调用上面这个 bash 文件，如何使用可以看 这篇文章 。

简悦设置

利用简悦的 自动化 与 同步助手的 增强导出 功能。

标准方案

此方案的前提是：使用简悦的知识库功能，如何配置 请看这里。

• 在标注的自动化上增加 导出 Markdown 的功能。

  

• 使用简悦官方适配的 Logseq Markdown 模板，将模板代码粘贴到 选项页 → 服务 → 定制化。

  

• 设置 Hazle 监控 output 变化，当出现 .md 文件时，自动转移（或复制）到 pages 文件夹下面。

  

  也可仅迁移文件名含有 xxxx@annote.md 的文件。

  

简易方案

此方案仅配置 增强导出 和 稍后读 & 标注的自动化，适合轻量级使用简悦的用户。

• 配置 增强导出

• 配置稍后读的自动化
  

• 配置标注的自动化，与标准方案时一致

• 设置 Hazle 监控 output 变化，当出现 .md 文件时，自动转移（或复制）到 pages 文件夹下面。

  

  也可仅迁移文件名含有 xxxx@annote.md 的文件。

  （与标准方案时一致）

至此

全部配置结束。

此方案的优缺点

优点

• 无代码化的全自动操作方案。
• 一次配置即可。
• 除 Github Page 外，其余均为 Local first 产品，此流程可保证最大稳定性。
• 发布的站点支持手机端访问。
• Logseq 可支持粘贴本地图片（到 assets 文件夹）配合 Hazel 自动提交功能，相当于拥有了自己的「图床方案」。

缺点

• 如果不是 Mac 用户或无法使用 Hazel 的话，效果不会那么完美。
• Logseq 因为是所见即所得的编辑方案，稳定性和切换编辑/预览效果没有 Typora 好。
• Logseq 并不是属于标准的 Markdown 结构（细节 看这里），所以再加上双链的话，迁移有一定成本。（
• 适度使用 Logseq 导出为 Markdown 改善此问题）

附录

关联

• 利用 DropIt 的文件夹监控功能，助力简悦标注自动导出到 Logseq

• 利用 Hazel 将 textbundle 修改为 Obsidian 可以预览的文件

• 利用 Keyboard Maestro 的文件夹监控功能，将简悦标记导入到 Logseq

更多关于 Logseq 的联动 请看这里。

导出为 Markdown

Logseq 自带了导出功能，可根据下图所示的方式导出为 Markdown，因为对 部分 Markdown 语法的不支持，尤其是 Ordered Lists 所以导入的 Markdown 还需要手动修改。

更多例子

来自 Kenshin's Note

[Kenshin]

嗨，各位。

简悦官方针对新用户或不喜欢配置的用户，发布了一个新功能：Logseq 配置库。

细节请看下面，几分钟就能配置成完成。

---

针对新用户的一步到位的 Logseq 配置库。

🗂 配置库

简悦 · 配置库 是简悦官方推出的一套针对新用户的极简配置方案，方便新用户用最快的方式使用简悦的各种高级服务，配置库内置了常用的双链笔记用法，如：Notion、Obsidian、Logseq、Roam Research，同时包含了简悦在阅读模式上的一些常规插件：Live Editor、题图、Safari 阅读模式等。

💡 特点

用户仅需要下载对应的配置库，修改里面的 UID 为自己的高级账户 UID，即可实现简悦的各种高级操作。

💁‍♂️ 受众

新用户或者不想使用手动配置的用户。

📝 如何使用

1️⃣ 下载

2️⃣ 修改为自己的 UID

3️⃣ 将必要的文件夹复制粘贴到相应位置

✅ Done！

📦 Logseq 配置库

因为 Logseq 与 Obsidian 在插件 API 的支持度有限，所以并没有轻量级使用方案，根据 Logseq 支持的文件格式区别两种方案。

这两种方案均需要同步助手，几乎无任何配置，支持本地快照，自动同步标注，可在 Logseq 中标注，适合 Logseq + 简悦的重度用户。

🔌 功能

1️⃣ 支持在 Logseq 中标注

2️⃣ 加入稍后读，自动保存本地快照

3️⃣ 加入标注时，自动将标注内容导入本地快照和 Logseq

4️⃣ 改变稍后读或标注的元数据时，自动将改动的内容保存到本地快照和 Logseq

📖 区别

📙 Org Mode 版

🔗 Github | 语雀

📗 Markdown 版

🔗 Github | 语雀

[yueh99]

gh-pages分支是什么时候创建的

[Kenshin]

照着教程做就行了 gh-pages 对 Github Page 来说是个特殊的分支。