发布方案

Obsidian 的发布方案

我选择的是最省事的 Digital Garden 插件配合 github 和 vercel 将文章发布到公网。
这是我的首页供大家参考:Welcom
其他关于发布的拓展与问题解决可以看:obsidian

为什么选择 Digital Garden 作为我的发布方案

Digital Garden 插件发布文章十分简单,通杀 Digital Garden 还适配 Obsidian 主题作为网站主题,支持双链、等等许多优点。配合 vercel 的自动构建和 CDN 基本上能烦恼我的就只有文章该怎么写这种世纪难题了。

搭建和部署

所用到的工具和网站

部署步骤

参考: 01 Getting started

  1. Obsidian 中下载 Digital Garden 插件
  2. 根据文档提示在 GitHub - oleeskild/digitalgarden 这个仓库中点击 Deploy 即可自动构建仓库和 Vercel 项目 image.png
  3. 等待项目构建完成后进入这个 链接 会自动为你创建条件合适的 token,如果不想过几个月就更新一下 token 可以选择将过期时间改为永久,默认是三十天,当然如果当心安全问题,也可以自己为单独的仓库设置 token 但是过期时间无法设置为永久,过程比较简单我就不一步一步去详述了
  4. 将刚刚获取到的 token 和你的 github 账号名和仓库名称填入插件中 image.png
  5. 配置到这就结束了,肥肠的简单

插件的设置

一定要关闭slugify note url这个选项

根据这篇issue,不关闭这个选项会在项目构建中对文件名进行路径处理,而如果路径中含有非英文字符则会构建失败导致无法访问这篇文章

下面是我的设置,有需要的同学可以参考
image.png

如何发布文章

dg-publish: true
dg-home: true
  1. dg-home 是告诉插件这篇文章应该是你的主页。(它只需要添加到一个笔记,而不是你要发布的每个笔记)。
  2. dg-publish 设置告诉插件这个注释所在的文章需要发布。没有此设置的注释将无法发布。(换句话说: 你发布的每个笔记都需要这个设置。)
  3. 通过在 Windows/Linux(Mac 上的 CMD+P)上按 CTRL+P 打开您的命令板,然后找到“Digital Garden: Publish Single Note”命令。按 Enter。就能发布当前笔记了

完成

现在已经完成了网站的构建和发布,是不是非常的简单。最后需要注意的一点 Digital Garden 构建的网站不支持网站内中文搜索,但是我们能借助搜索引擎来弥补这一缺点。当然还有其他的解决方案,比如 lunr.js 修改为 jp 则可以同时兼容英文和中文(当然效果一般),又或者接入 jieba 分词等等,但是都需要修改源码很麻烦。当然也可以用 Digital Garden自定义组件 去添加自定义的搜索组件,但是难度相对较大,我又很懒。

Check
Bug

路径渲染错误 bug
经过测试,需要在文章上传好后再更新带有 dateview 的页面,如果在文章上传之前更新 welcome,则会因为构建仓库没有这篇文章而路径渲染错误。严格来说这不是 BUG

关于大陆访问无法加载局部关系图的问题:Digital Garden国内访问大框问题