obsidian 目前最完美的免费发布方案 - 渐进式教程 - 经验分享 - Obsidian 中文论坛
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
功能点详细比对:
功能点和限制 | jekyll方案1 | 官方收费发布方案 | hugo方案(quartz) | logseq方案 |
---|---|---|---|---|
反向链接面板 | 支持 | 支持 | 支持 | 支持 |
正向链接预览 | 支持 | 支持 | 支持 | 支持 |
支持搜索 | 不支持,但通过google间接实现 | 支持 | 支持,但中文不兼容 | 支持 |
链接稳定性 | 只要文件名不改,链接就稳定 | 受文件夹和文件名同时影响 | 只要文件名不改,链接就稳定 | 只要文件名不改,链接就稳定 |
文件夹层级显示 | 无 | 支持 | 无 | 无 |
首屏加载速度 | 极快,2s内,下载资源<1M | 中等,5秒内,下载资源<5M | 极快,2s内,下载资源<1M | 超慢,10秒,下载资源<30M |
图谱显示 | 支持全局图谱,但1K+笔记就很卡 | 完美支持 | 支持局部图谱,中文支持不友好 | 支持,稍卡 |
横向卷动布局- andy mode | 不支持 | 支持 | 不支持 | 不支持 |
暗色模式支持 | 不支持 | 支持 | 支持 | 支持,但固定,不能切换 |
移动端支持 | 支持 | 支持 | 支持 | 支持 |
markdown扩展语法支持 | 只支持基本md语法和[[语法 | 支持obsidian的callout和别名语法 | 只支持基本md语法 | 只支持基本md语法和[[语法 |
其他限制 | 必须要有YAML区 | 收费 | 必须要有YAML区;不支持[[wikilink格式,需妥协 | 语法上需要一点克制 |
精力有限,就只对比这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/数字花园
即可看到笔记。
- fork这个jekyll开源模板:GitHub - oldwinter/dg 118
- 2.netlify配置自动构建。
- 按照这个教程手把手教你使用Netlify部署博客及部署自动化 - 知乎 42,界面一步步点,都按默认配置来,从而将上一步fork的自己仓库,通过netlify构建和发布。
* 主流的免费的还有github pages和vercel服务,前者缺少CDN导致国内访问很慢,后者存在非html后缀的链接报404错误的问题。 - 完成上一步后,应该能得到一个
https://master--zippy-dango-d43c8d.netlify.app/
类似格式的网址,打开后正常显示原仓库的页面即可。
- 按照这个教程手把手教你使用Netlify部署博客及部署自动化 - 知乎 42,界面一步步点,都按默认配置来,从而将上一步fork的自己仓库,通过netlify构建和发布。
- 3.将本地全部文件push至github。
- 本地仓库的根目录执行git三件套:
git add .
git commit -m "first commit"
git push
* 有能力的朋友,可以将这个步骤,用效率工具,包装成一个定时执行或一键执行的命令。 - 回到netlify页面,应该能看到它开始被push操作触发了构建动作,等几分钟后,打开得到的新网址,看是否已经包含了obsidian笔记库内容,链接为
域名/笔记名
。例如我的obsidian笔记库里面有数字花园
这条笔记,则访问https://master--zippy-dango-d43c8d.netlify.app/数字花园
即可看到笔记。
- 本地仓库的根目录执行git三件套:
- 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 ⤴️