Notes

基于Obsidian+Docsify+Github Pages的个人笔记，用于整理学习的知识。

最近（2021-12-11）发现Obsidian+Docsify+Github Pages这一套搭配很适合来建立（线上的）个人知识库，而且都是免费的。

这一套搭配的优点有：

• 所有的工具、资源都是免费的
• docsify生成文档网站非常简单，只需要创建一个 index.html
• 相比于“文件夹+Markdown”，Obsidian在保证了本地化的同时，提供了更高效的文档组织管理方式

这一套搭配的缺点有：

• 前期配置和学习使用有时间成本
• Github Pages没啥流量，搭建站点是自娱自乐

implementation

基础选项/乞丐版：

1. 下载Obsidian软件，将vault建立在你的云盘（icloud）文件夹下。
2. 直接在云盘vault文件夹下初始化docsify（不要选择新建docs目录）。
3. 在本地建立一个文件夹，复制云盘文件夹下所有文件到本地文件夹的docs目录。
4. 在Github建立新的repo，将你的本地文件夹上传，设置该repo的docs目录为Github page的Source。

进阶选项：

1. 支持网页图片：
   1. 取消“设置->文件链接->使用wiki链接”这一项。
   2. “设置->文件链接”中新附件的位置为“当前文件夹的子文件夹”。
2. 一些常用命令写成bash脚本
   1. 用cp命令拷贝你的vault文件夹，参考我写的bash脚本cp.sh
   2. git push也可写成脚本push.sh

logs

• 2021/10/12 添加了sidebar侧边栏、插件katex（用于支持数学公式）
• 2021/10/13 添加了bash.sh文件（命令行交互界面）、插件Pagination（用于分页导航）
• 2021/10/15 添加了Prism插件（用于Python代码高亮）
• 2021/11/27 添加了代码复制、字数统计、PDF嵌入插件，更新了themecolor，添加live2d看板娘模型
• 2021/12/02 支持Obsidian编辑Markdown文档，再通过Github Pages发布，Docsify渲染
• 2022/01/20 添加了导航栏Navbar，访问量统计
• 2022/01/25 修改了live2d的位置和大小、搜索功能插件

links

相关资源汇总

• docsify 中文文档
• 我的Github示例项目
• docsify 教程1、教程2
• obsidian 知乎精华回答
• 文档构建说明书