obsidian 目前最完美的免费发布方案 - 渐进式教程 - 经验分享 - Obsidian 中文论坛

Omnivore

Read on Omnivore

Read Original

date_saved: 2023-08-10 16:33:40

date_published: 2022-07-14 04:37:29

Full Content:

可以访问此文的双链版本，获得完整阅读体验：obsidian 目前最完美的免费发布方案 - 渐进式教程 - oldwinterの数字花园 525

几个发布方案对比

支持双向链接是底线，否则随便用一个主流的静态blog方案就行了。

先看最终方案的发布页面效果： oldwinterの数字花园 567

和obsidian的官方发布方案做个对比： oldwinterの数字花园 168

功能点详细比对：

精力有限，就只对比这4种方案了。下面列上我目前体验对比过的全部第三方开源发布方案，供各位参考，也可以持续观察作者后续的开发进展，再择优选择。

• jekyll方案1，即我选用的方案。GitHub - maximevaillancourt/digital-garden-jekyll-template: Start your own digital garden using this Jekyll template 287
• jekyll方案2，一位印度老哥写的 55
• hugo方案(quartz)，jackyzha0 (Jacky Zhao) · GitHub 129
• logseq方案，GitHub - pengx17/logseq-publish: Logseq Publish Action 41
• zola方案，GitHub - ppeetteerrs/obsidian-zola: A no-brainer solution to turning your Obsidian PKM into a Zola site. 19
• perlite方案，GitHub - secure-77/Perlite: A webbased markdown viewer optimized for Obsidian 22
• gatsby方案，支持横向卷动布局- andy mode，但构建时长小时级别，GitHub - aravindballa/gatsby-theme-andy: A Gatsby theme to build Andy style websites. 37

总之，有钱就选官方服务准没错。其次，综合对比后，我选择了jekyll方案1，如何一步步实现，见下文。

渐进式教程

注：程序员朋友预估10分钟之内能搞定。纯小白也许需要花费30分钟以上。有能力的朋友，可以直接根据原作者的readme进行部署和发布，不需要看我的汉化啰嗦版

总的来说：

通过基于jekyll开源的静态blog模板，通过git push自动触发netlify进行构建操作，将md文件转换成静态服务器可以识别的html文件。

一步步来说：

• 1.本地调试。
  • fork这个jekyll开源模板：GitHub - oldwinter/dg 118
    * 有能力的朋友，建议fork原作者的，自己进行定制改动。
  • git clone自己fork的仓库地址到你电脑本地：git clone <YOUR_COPIED_URL_HERE> my-digital-garden
  • 进入刚才clone的仓库的目录，cd my-digital-garden
  • 执行依赖库安装命令bundle
    * bundle是ruby的包管理器，所以可能还需要先安装ruby语言环境，请自行搜索教程。
    * 如果因为网络问题导致依赖库安装很慢，请自行搜索解决。
  • 执行本地调试命令bundle exec jekyll serve，接着浏览器打开http://localhost:4000看是否正常显示页面。
  • 将obsidian库全部要发布的文件用linter插件加上YAML格式的frontmatter区，然后拷贝至_notes_目录。
    * linter插件支持一键对全库进行markdown格式美化，强烈推荐。执行前请先备份。
    * 有能力的朋友，可以直接将obsidian笔记库添加为git submodule。
  • ctrl + c 停止bundle exec jekyll serve命令，并重新执行。接着浏览器打开http://localhost:4000/笔记名。例如我的obsidian笔记库里面有数字花园这条笔记，则访问http://localhost:4000/数字花园即可看到笔记。
• 2.netlify配置自动构建。
  • 按照这个教程手把手教你使用Netlify部署博客及部署自动化 - 知乎 42，界面一步步点，都按默认配置来，从而将上一步fork的自己仓库，通过netlify构建和发布。
    * 主流的免费的还有github pages和vercel服务，前者缺少CDN导致国内访问很慢，后者存在非html后缀的链接报404错误的问题。
  • 完成上一步后，应该能得到一个https://master--zippy-dango-d43c8d.netlify.app/类似格式的网址，打开后正常显示原仓库的页面即可。
• 3.将本地全部文件push至github。
  • 本地仓库的根目录执行git三件套：git add . git commit -m "first commit" git push
    * 有能力的朋友，可以将这个步骤，用效率工具，包装成一个定时执行或一键执行的命令。
  • 回到netlify页面，应该能看到它开始被push操作触发了构建动作，等几分钟后，打开得到的新网址，看是否已经包含了obsidian笔记库内容，链接为域名/笔记名。例如我的obsidian笔记库里面有数字花园这条笔记，则访问https://master--zippy-dango-d43c8d.netlify.app/数字花园即可看到笔记。
• 4.定制自己的首页、网站名和样式
  • 首页修改。修改_pages文件夹下的index.md即可，可直接参考dg/index.md at master · oldwinter/dg · GitHub 16
  • 网站名修改。修改根目录的_config.yaml第一行title字段即可。
  • 有能力的同学，自己根据jekyll官方文档，定制自己的界面和样式即可。
  • 完整重复步骤3，看更改是否生效。
• （可选）自定义自己的域名
  • 在netlify界面按提示一步步操作即可，需要有自己的域名且已经备案。
  • 第一次购买并备案域名的经验
  • DNS解析

写在最后

我在践行obsidian笔记库全量开源的想法（代码能力不够，笔记来凑），欢迎捧场来赏赐1个star​：GitHub - oldwinter/knowledge-garden: 真实袒露的第二大脑 second brain，未经美化的数字花园 digital garden 158

此外，如果你对『建设数字花园，也就是公开发布自己的双链笔记』这件事儿感兴趣，欢迎加我微信：oldwinter2，我拉了个10+人小群，只交流这个事儿。而obsidian、logseq或其他笔记使用入门，请不要加我哈，这些有不少专门的新手讨论群，可以b站或百度搜一搜。

• 最后回复19 天
• 7.7k

浏览量

• 11

用户

• 18

赞

• 14

链接

感谢分享。
cloudflare Page也支持从仓库直接拉去构建，访问速度应该会更快些。GitHub page其实也能用，部分地区快部分不快。
从NameSilo国外大厂买域名不用备案，还支持支付宝。

感谢兄弟，你这回复太有价值了。看来我之前需要备案就是因为从阿里云买的域名。。只怪当年太年轻。哈哈。我看了一下你推荐的网站，xyz域名也10元左右就能搞定，可以的。cloudflare page我也打算去玩玩看。github page我在浙江这边访问感觉有点不稳定，看网上评测也都是netlify和vercel速度快很多，反正花费的时间其实差不多的，看情况自选即可。

国外page其实都按地区，都不算最稳定，不过之前看过一些测速，netlify应该是这三四家中国内最慢的了。最快的估计是国内的page服务，只不过要稍微担心审核无故被ban。

请教一下楼主，这个有在群晖的docker上配置的可能性吗

如果我正确理解了你的问题的话，答案是没问题的。就相当于将群辉当做netlify中的server。然后你将一个静态server进行docker化，挂载你的库即可。当然对非软件相关专业的，可能还是有点小难度的，你要搞要慎重哈。

这个发布方案真不错，速度快也简单省心！等我笔记搭好了也选用啦！谢谢大咖！

我使用了quartz方案，发现了一个奇怪的问题。

当我的文件名为非英文时，最后更新时间会显示Last updated Unknown。

不知大佬是怎么解决这个问题的

我是打算用 ob 写好，然后构建使用 gitbook 的形式 push 到 github pages

想阅读更多？请浏览经验分享中的其他话题或查看最新话题。

Highlights

总之，有钱就选官方服务准没错。其次，综合对比后，我选择了jekyll方案1 ⤴️