2 min read

或许是搭建「数字花园」的最佳方案?

我理解的「数字花园」,不过是「个人博客站」的一个变体,花园里可以是个人博客,可以是系统笔记,可以是项目、作品……也可以都有。大家种的东西不一样,打理的方式也不一样。

如果你想了解什么是「数字花园」,这篇文章会给你带来一些帮助。

我一直想把本地积累的 Mac 使用笔记作为网站发布出去,折腾了一阵子 Ghost 自建站方案,又对比了 Notion、飞书文档、FlowUs 等笔记发布平台,最终我发现 Obsidian + Quartz + netlify 的组合或许是最优解。

这个方案有什么好处?

首先是免费。Obsidian 客户端是免费的,Quartz 是开源的,Github 免费,netlify 免费(甚至可以免费绑定自己的域名和生成 SSL/TLS 证书)。

其次,实现起来(还算)简单,配合 AI 工具便能自行搭建,有一点点编程经验就更好了。Obsidian 也有非常多的插件可以帮助实现一些功能。

最后是安全,从数据(笔记)到网站(开源项目)都掌握在自己手里。

差点忘了,这个方案实现的网站在中国大陆也可以顺畅访问。

下面大体说一下实现,一些技术实现细节不在此赘述,交给 Google 或 AI 就够了。

用到的材料:

  • Obsidian:本地写作
  • Git:Obsidian 插件,可以把本地 markdown 文档 push 到 GitHub
  • GitHub:存放 Quartz 项目和 markdown 文库
  • Quartz v4:开源的「数字花园」建站工具
  • Netlify:把(Quartz + markdown 文库)项目代码部署成网站、绑定域名等

搭建过程:

  • fork Quartz v4 到自己的 Github
  • clone 项目到 Mac 本地
  • Obsidian 打开项目下的 /content 目录,作为 Obsidian 的文章(笔记)本地仓库
  • 安装并启用 Obsidian Git 插件
  • 注册登录 Netlify 并关联 Github 项目作为 project 网站(可免费绑定自己的域名)
  • 在 Obsidian 上编辑文章(笔记)后,按 Git 插件的 Commit-and-Sync 按钮即可实现发布(自动 Push + Netlify 部署)。

注意1:Netlify 项目配置里,Build & deploy settings - Build settings 下,需要填写设置:

Build command: npx quartz build
Publish directory: public

注意2:Obsidian 设置-核心插件-模版 里可以启用并制定模版文件 templates/note.md

---
title: 
description: 
permalink: 
date: 
tags:
---

我甚至在考虑要不要把我的个人博客和日记以及备忘录笔记都用这套方案来重新构建。

对了,你可以访问 macbiji.com 来查看我的Mac使用笔记。