双链笔记的发布方案Quartz

双链笔记随着 rr 的兴起而出现的一种笔记方式，利用正链和反链来构建整个笔记系统，而不是靠分类和标签来管理笔记，更加注重系统性，使零碎的笔记链接起来，立体起来。

前言#

我在之前的文章中分享过 [[Obsidian 的分享攻略]]，这种分享方式更多的是传统的单文章的分享，利用分类和标签来管理文章，更适合于多维度的去分享相互之间的弱链接关系，以后也基本不用维护，这是 Blog 系统的优势。

而对于双链笔记更多的是针对一个系列的内容整合，它既分散又整合，分散的是文章整篇内容，关联的是内容中的部分，做到了笔记系统的耦合性。

构建属于自己的数字花园#

Blog 更注重的单体分享，而数字花园注重的深度的浏览。

在双链笔记发布这块做的比较好的是 [[Obsidian]] 的 publish 系统，[[logseq]] 的网页导出分享等等，这些工具和笔记 app 本身比较耦合，定制性比较差，偶然间发现 [[quartz]] 这个基于双链的分享工具，较为符合自己的要求。

工具#

Quartz：双链系统发布工具
VPS/vercel/cf pages：[[quartz]] 托管平台
rclone/git：内容同步工具
Obsidian/logseq/vscode/emacs：具有双链系统的书写平台。

效果图#

主页#

dawnz

图谱#

graph

标签和文件夹页面#

tag

Quartz 部署#

[官方文档](Welcome to Quartz 4 (jzhao.xyz))，同时也是最新的 Demo，可以查看部署效果，以及特性和定制化的内容

安装和初始化 [[quartz]]
[[quartz]] 支持利用 nodejs 直接部署，以及利用 docker 部署。

# nodejs 部署和初始化
$ git clone https://github.com/jackyzha0/quartz.git
$ cd quartz
$ npm i
$ npx quartz create

# docker部署
$ git clone https://github.com/jackyzha0/quartz.git
$ docker run --rm -itp 8080:8080 $(docker build -q .)

配置quartz.config.ts 和quartz.layout.ts文件
quartz.config.ts 文件主要是配置网站信息，主题自定义以及插件系统，默认基本不用动，只需要更改一下网站信息即可，具体参考Configuration (jzhao.xyz)。
quartz.layout.ts 文件是配置布局，默认有 3 个布局样式可以自定义：
- sharedPageComponents ：这个是配置分享页面内容的，主要是配置页脚信息。
- defaultContentPageLayout：这个是配置文档页面布局的，注意主页也属于文档。
- defaultListPageLayout ：这个是配置标签页和文件夹页面布局的。
- 布局参考：Layout (jzhao.xyz)
- 组件参考：Components (jzhao.xyz)
生成和预览
$ npx quartz build --serve ，默认监听在 8080 端口，支持热重载，但是不支持网络文件系统的热重载。

同步内容#

[[quartz]] 的文档内容全部在content目录，该文件夹下应该有index.md 作为主页，content 中的文档结构会默认的渲染成路径。

我之前的文章中写过，我是用onedrive 来同步内容的，所以我采用的是rclone 同步方案，把 OneDrive 中的库同步到 vps 后生成部署的。

OneDrive 方案#

$ rclone sync -v onedrive:/Notes quartz/content 把 OneDrive 中的库同步到content即可，注意这个方案 [[quartz]] 不支持热重载，也不支持完全不支持，但是动作较为奇怪，达不到预期，主要就是explorer 这个插件达不到预期，我自己并不需要实时的更新，所以采用定时任务固定时间同步了。

每隔 1 小时同步一次
0 */1 * * * /usr/bin/rclone sync -v onedrive:/Notes quartz/content >> rclone-sync.log 2>&1
每隔 1 小时生成一次
3 */1 * * * cd quartz && rm -rf public && npx quartz build >> quartz.log 2>&1

Git X vercel 方案#

我并没有使用这个方案，如果你的文档库是使用 git 的，不妨试试这个方案。
参考文档：Hosting (jzhao.xyz)

思考#

双链笔记系统是构建一整个思路的系统，应更加的注重文字，而非图文和视频类，图片和视频还是更加的适合于博客这种。

需要深度的去体验才能感受到双链的魅力。