关于本站

杨祖攀约 2168 字大约 7 分钟

网站简介

本站是我（攀哥）搭建的一个个人知识库网站，我也把它叫做 知识花园^[1] ，主要包含了我在学习、编程、折腾、创业等几方面的一些笔记或者心得。

注意

本站的内容，可能存在错误，阅读时仅供参考，如有错误，请及时联系我，并敬请大家谅解。

心路历程

我为什么建这个网站？

我在学习的时候，我习惯做一些笔记，这看起来很好，对吧，但是时间一长，我的笔记很乱，这个文档里有一篇，那个文档里有几篇，没办法形成体系。这个问题很恼火，一直困扰着我，我也在不断的寻找解决方法。

尝试在线笔记

我先后尝试后印象笔记、有道笔记、为知笔记、 OneNote、Notion、我来、FlowUs、语雀、Obsidian、Typora 等笔记软件。刚开始的时候，我把我的笔记都搬到了云笔记软件上，我觉得还挺好用的，但是用着用着就出问题，有的功能你得开会员，不开会员就不给你用了，比如分享功能。那行吧，就开个会员，这些都还能接受，最让我接受不了的是，导入笔记容易，导出笔记难，懂得都懂。

在线笔记的好处：

用完就走：打开一个链接就可以直接开始编写，很方便。
共享方便：一键生成分享链接，分享方便。
权限控制：可以设置各种不同的权限。
功能丰富：能在文档中插入流程图、思维导图、数据表等。

但是云笔记有一个无论如何都无法避免的缺点：你的笔记并不属于你！

只要你使用云笔记，你的文档全部存在于各大公司的服务器之上，包括这些文档的解释权、访问权都不属你。

注意

这里不是说云笔记不好，只是说每个人的需求不同而已，根据自己的需求选择即可，这里我只是表明我的观点。

继续寻找

接着，我又开始了我寻找之路。最后，找到一个让我相对满意的解决方案： Markdown + Vscode + VuePress + Github。这种方案的好处是：方便阅读、方便修改、简单、兼容性好。但是这种方案有两个问题：一个是图片，一个是分享。

Markdown 中图片的处理会比较麻烦，传统的例如 word 等文件格式它会将图片一起打包到文件中，但是在 md 当中图片更像是文档的依赖文件，是游离于文字之外的东西。

然后，我又开始研究图床，找到图片的解决方案： Markdown + picGoopen in new window / PicListopen in new window ，图片通过图床外链放在 Markdown 文件中。

至于分享，倒是很好解决，我们可以使用 Github Pages 解决这个问题，同时我们也可将 VuePress 生成的静态资源托管到 Cloudflare Pages 、Netlify等服务商。通过服务商提供的默认域名即可访问的我们的笔记资源，我们也可以绑定我们自己的域名。如果我们的域名在国内以及的备案的话，还可以将静态资源托管到国内云服务器上，或者国内云服务器的对象存储。这样在国内的话，访问速度提到提升。

最终方案

自已折腾了小半年后，最终找到了我比较满意的方案：Markdown + Git + VuePress + Github + GitHub Action +Github Pages/Cloudflare Pages。

提示

在这里，我也要感谢 𝓜𝓻.𝓗𝓸𝓹𝓮open in new window 这么棒的主题及其相关配套的插件open in new window。

网站定位

本站是一个非盈利项目，从项目开始准备的时候就没有想通过这个项目盈利。
本站是我个人在学习过程中的一些思考或者记录，具有一定的主观性，在阅读时仅供参考。
为了大家的阅读体验，本网站不会接入广告，现在不会，以后也不会（因为我很讨厌广告了）。
至于网站的成本开支，主要由我个人来承担，同时我也会接入捐助来平衡支出。（当然捐助是个人自愿的，我不会强求任何人给我捐助。）
同时，本项目也是一个开源项目，网站内容 采用署名-非商业性使用-禁止演绎 4.0 国际标准open in new window协议，网站源码 采用 MIT 协议。