如何将 Obsidian 文章发布至个人网站？

• 插件：obsidian-digital-garden
• Digital Garden 插件官方文档

准备

1. 准备 GitHub 模版仓库与 Token

   • Fork 模版：访问 GitHub 上的 oleeskild/digitalgarden 仓库，点击右上角的 Fork，将其复制到你的个人 GitHub 账号下。
   • 创建 Personal Access Token (Classic)：
     • 进入 GitHub Settings -> Developer Settings -> Personal access tokens -> Tokens (classic)。
     • 点击 Generate new token (classic)，勾选 repo 权限。
     • 复制生成的 Token 备用（仅显示一次）。

2. 配置 Obsidian Digital Garden 插件

   • 安装插件：在 Obsidian 中打开 设置 -> 第三方插件 -> 浏览并搜索 Digital Garden，点击安装并启用。
   • 填写连接配置：
     • GitHub Repo Name：填入 Fork 的仓库名（例如 digitalgarden）。
     • GitHub Username：你的 GitHub 用户名。
     • GitHub Token：粘贴刚才生成的 Personal Access Token。
   • 选择发布基础设置：在插件设置中可根据偏好开启 Show Backlinks（反向链接）、Show Local Graph（局部关系图）或 Enable search（站内搜索）。

3. 在 Cloudflare Pages 部署网站

   • 登录 Cloudflare：进入 Cloudflare Dashboard，左侧导航栏选择 Workers & Pages -> Create application -> Get started（底部有个“Looking to deploy Pages”） -> Import an existing Git repository
   • 选择仓库：授权并选择刚才 Fork 的 digitalgarden 仓库，点击 Begin setup。
   • 配置构建参数：
     • Project Name：自定义网站项目名。
     • Production branch：main。
     • Framework preset：选择 None。
     • Build command：npm run build
     • Build output directory：dist
   • 部署：点击 Save and Deploy.

编写与发布

在笔记 yaml 部分添加属性：

• dg-home: true: 将该笔记作为网站的主页。只有一个页面可以设为 true
• dg-publish: true: 将笔记发布到网站。
• dg-permalink: "aaa/bbb"：自定义该页面的 URL 路径，比如 yoursite.pages.dev/aaa/bbb。注意！如果你的笔记文件名为中文，那么必须自定义 URL 路径。因为 URL 不支持中文。可以随便打点乱码，比如 awudhi。
• dg-path: "Lecture/MIT6.5840/uhwdo"：改变该文件在网站导航树中的虚拟文件夹层级结构。
• title: "your-title"：覆盖页面在网页端显示的标题（若不设置，默认使用文件名或第一级 # 标题）。
• tags: [分布式系统, Go语言]：页面标签，会在网站上生成对应的标签分类和筛选。也可以写为以下格式：

---
tags:
  - summary
  - life
---

其她：

• dg-pass: "your-password"：为该单篇笔记设置访问密码。未输入正确密码前，访客无法阅读内容。
• dg-pinned: "true"：在侧边栏导航树中将该笔记置顶显示。
• dg-hide: true：想整篇笔记都不出现在网站的导航、搜索、图谱等任何地方，只可以通过链接访问
• dg-hide-in-filetree: true：只从文件树中隐藏，但在搜索和图谱中依然可见。
• dg-hide-in-graph: true：只从图谱中隐藏。