## 缘起
```{article-info}
:avatar: https://3139822.xyz/img/avatar_hu_628c03c67df41893.png
:avatar-link: https://3139822.xyz/
:avatar-outline: muted
:author: 醉摘镜中花
:date: Sept 28, 2025
```
把笔记记到纸质笔记本上?本人的笔记本只有在记笔记的时候才会打开。
从一开始,我是想有一个自己的博客的,自己手写一个博客吧,实力不允许(连HTML都不会)。并且一直没有找到一个自己喜欢的博客界面,所以写博客之路一直在酝酿着开始。
本人在刚开始把笔记脱离纸质笔记本,是把笔记记录到markdown上的,但是也从来没有看过,后来越记越多,也越乱,打开之后也不想看了,最后也只是放在文件夹里吃灰。正所谓“吾生也有涯,而知也无涯。以有涯随无涯,殆已!”,本人彻底放弃了瞎搞的念头(没有彻底),连markdown笔记都不想写了。但是,对本人来说,网上的资料多而杂,而且有些内容似乎有错误之处,我发现,不把他们归类整理总结,想要学会它们是不可能的(对本人来说)。
为了方便自己随时查看自己的笔记,我发现把笔记放在网上是比较方便的,但是纯放在网上也不方便,我不想上网怎么办?经过自己的不断探索,发现了一些使用markdown记文档并把文档发布在网上的方法,不联网和联网都可以查看自己的笔记。这真是老天有眼,同时自己也足够的幸运,也从网上找到了一些资料(感谢各位分享者),慢慢的,我对我的网络笔记文档有了初步的构想,并在2024年差不多年底的时候通过[jupyterbook](https://jupyterbook.org/en/stable/intro.html)写了一个文档,然后生成静态页面,发布到了网上,并且可以通过ip地址访问(在阿里云租了一个服务器)。我当时非常的激动,但是文档一直没有写什么有用的内容(一直在搁置),其实是因为自己什么技术都不会,也不知道写啥。
再到后来发现[jupyterbook](https://jupyterbook.org/en/stable/intro.html)有更新,升级出了[jupyterbook2](https://next.jupyterbook.org/),本人想用新产品,但是没有学会,也不太想折腾了,写个笔记还让我搞来搞去的,太麻烦了,然后我说,算了,不想再折腾了。后来,有一次偶然的机会,研究了一下[Sphinx](https://sphinx-doc.cn/en/master/),发现里面有好看的主题,就是现在我使用的这个主题[furo](https://pradyunsg.me/furo/quickstart),通过我的不断研究,竟然真把通过Sphinx写的文档发布到了网上,可以通过互联网访问了,我又有点激动了,不过能发布到网上有什么用呢,有内容才是最重要的,所以我就整理资料写笔记了(非常缓慢),但是一直没有往网上部署。然而,我的阿里云服务器还没有到期,我就在一直瞎搞我的服务器,一直没有搞自己的文档笔记。
```{note}
我之前也了解过一段时间[Sphinx](https://sphinx-doc.cn/en/master/),完全是瞎搞(我当时只知道它是一个写文档的东西,连它有好看的主题都不知道),一看页面布局,这不是我喜欢的布局类型,就没有再研究了。
```
说实话,一开始写文档的时候,我是想把文档当做个人博客来用的,左边是总体的目录章节,中间是文档内容,右边是文档的章节标题信息,我非常喜欢这种结构,唉,可是自己实力有限,这辈子想手写一个自己的博客是玩玩是不可能实现的了。于是我把自己手写博客的想法彻底放弃了,然后搜集一些博客框架,我发现了一个好看的博客框架,[halo](https://www.halo.run/)博客框架,我尝试着把它搭建到我的阿里云上面,安装了一个好看的主题[Hao](https://www.halo.run/store/apps/app-MgZJX),里面有些写文档的插件,安装之后可以更好用。但是这并不适合我,我的操作步骤是这样的,从浏览器连接并登录到[halo](https://www.halo.run/)的后台,在[halo](https://www.halo.run/)的后台上写文档,服务器带宽是3Mb的小水管,再加上服务器性能有限,我用了几天,绷不住了,卡的我精神都快出问题了。另外,我也不喜欢这种写文档方式,它的文档好像还是存到数据库里面的(我不清楚),这让我对我的文档没有掌控的感觉,而且还非要联网才行,在服务器没有崩溃的状态下,我先崩溃,实在是受不了,我关闭了这个博客。
```{note}
我补充一点,Hao的现代科技风太科技了,给人高大上的感觉,看着技术含量就很高,我感觉这种高大上和我的博客内容差异太大,我的博客内容与主题类型严重不符,使用这种主题写我的博客,对我来说简直是在西餐厅吃臭豆腐,智障误入少年班,这个画面你可以想象一下。
```
现在我有个疑问,网上有这么多个人博客,你们到底是怎么写的?用着低性能的服务器,难道你们的服务器就不卡吗?你么是怎么做到不卡的?或者是你们都有钱,买的都是高性能服务器?经过我看到的一些个人博客来说,有一部分博友是用着低性能服务器的,不知道你们是不是有什么高级操作,写博客都非常方便,而且不卡,为什么我感觉我的博客卡到爆,难道是我操作不当导致的?对此我表示极度怀疑。但是我也发现过一些富哥,服务器配置高的离谱,如果在阿里云租一台的话,那简直是天文数字,或许你们没有卡顿的烦恼吧。我还发现有些博友的网站,什么现代科技风主题风格,什么魔改主题,而且网页打开速度极快,博客内容又是什么高级技术,各种博友五花八门,各种折腾,疯狂输出内容,这些博友简直强的可怕,我只能说不打扰,我先溜了。
不知道怎么回事,有一天我也不知道搜索了什么,了解到了[Hugo](https://gohugo.io/),号称The world’s fastest framework for building websites,这种博客是通过自己写的markdown文件本地构建的,我了解了一下,这正是我现在比较喜欢的一种方式。随后我看到了一个低调,简洁,典雅的主题[Stack](https://stack.jimmycai.com/),主界面大概分成了三列,我觉得这个主题比较适合我。于是我就找教程,花了几天学习了一下,前前后后大概一两个星期吧,包括问老外问题,终于是把网站部署上了。
博客网站部署上之后,我把我的文档网站链接放到的我的博客里面,算是给我的文档网站找了一个家,我也有了写博客和文档的动力,希望我不会半途而废。