Obsidian 发布方案实践

数字花园发布方案对比 中已经选型对比了几种发布方案，本篇文章主要基于 Quartz 发布方案来进行一步步得实操。原文见：Obsidian发布方案实践。

Quartz 发布方案

一、详细步骤

1.安装环境

• Quartz 运行需要 node.js 20 版本以上，npm v9.3.1 才能正常运行。

  1. 下载安装 NVM：nvm下载地址 或者自行下载 Node.js
  2. 命令行窗口完成以下命令操作
  batch

  # 下载node
  nvm install 20.17.0
  # 列出所有已下载的node版本
  nvm ls
  # 使用指定的node版本
  nvm use 20.17.0

2.拉取示例库

# 本地需要安装git,命令行窗口完成以下命令操作
git clone git@github.com:jackyzha0/quartz.git

3.设置镜像

# 设置镜像源，其他镜像详见下文
npm config set registry https://registry.npmmirror.com
# 为quartz下载依赖
npm i 

npm 镜像仓库

• npm 官方原始镜像网址是：https://registry.npmjs.org/
• 淘宝 NPM 镜像：http://registry.npmmirror.com
• 阿里云 NPM 镜像：https://npm.aliyun.com
• 腾讯云 NPM 镜像：https://mirrors.cloud.tencent.com/npm/
• 华为云 NPM 镜像：https://mirrors.huaweicloud.com/repository/npm/
• 网易 NPM 镜像：https://mirrors.163.com/npm/
• 中国科学技术大学开源镜像站：http://mirrors.ustc.edu.cn/
• 清华大学开源镜像站：https://mirrors.tuna.tsinghua.edu.cn/

4.本地运行

• 将使用 Obsidian 创建的笔记文件放入 content 文件夹执行以下操作

  batch

  # 初始化
  npx quartz create
  
  # 选择empty Quartz
  # 选择Treat links as shortest path
  
  # 启动服务
  npx quartz build --serve
  
  # 访问localhost:8080验证

小结

• 经过以上四步，本地应该就已经可以访问到发布的测试笔记了。此时就可以向在一起的女友或者同学们吹一波分享一波了。
• 但是远在别处的人还是访问不了，这 B 装的不大啊这分享的范围太小啊。为了这点爽感，那就需要继续折腾构建线上的数字花园了。

参考

• Welcome to Quartz 4

补充 -jekyll 发布方案

步骤

• 下载模板：参考 Quartz 类似的操作
• 下载 ruby：官网下载
• 本地运行测试（本地文件放入 note 目录中，本地运行命令，构建将耗时按照分钟计）

参考

• jekyll首页示例
• 使用 Jekyll 建立自己的数字花园
• jekyll模板库