从CSDN到Hexo

从文档写作开始,经历了多个平台的实践。最开始在CSDN上进行博客写作,到现在利用Hexo自建博客网站,中间还通过sphinx+github+readthedocs进行文档管理。不同的写作平台和写作方式有长处也有短处,小结一下

CSDN

持续时间:20154月-至今

最开始接触的就是CSDN,因为之前经常会在上面查阅资料,所以后来就注册了帐号开始写作

15年刚考上研究生,开始写博客的目的就是为了毕业的时候可以展示我的学习成果,但是后来在坚持写文章的过程中,发现写作的好处非常明显

有一种说法是写出一篇完整的文章能够理解至少90%的知识点,而且还能够通过理清这个知识点相关的问题进一步发散到其他知识点;以此同时,在往后的查阅和复习过程中能够给你快速的提示

刚开始的CSDN使用富文本编辑器进行写作,后来也支持了Markdown编辑器,中间也推出了博客专栏,专门用于系列文章的整合。但是相较于后面的写作方式,对于文章的编辑修改操作比较繁琐,也不利于系列文章的发布,对图像、数学公式等功能的支持也不是很完善.

小结:在CSDN发布的博客比较倾向于单篇文章,较少的图像和数学公式

sphinx+github+readthedocs

持续时间: 201812月-至今

写作一段时间后,发现有些内容比较复杂,需要用很长的文字+图片+公式+代码去解释,这样的内容需要很长一段时间进行编辑.如果都在一篇文章里,会导致阅读性大大降低;如果分成多篇文章,中间很可能会穿插其他文档,打断阅读的连贯性.

为此苦恼了一段时间,偶然的情况下发现sphinx,能够生成html文档,这种方式对于系列文章的发布真的是福音;再结合github进行远程存储,readthedocs进行远程发布,真真的是一个好字

不过经过一段时间的写作之后,发现其中还是有一个问题:

sphinx默认使用reStructuredText语法进行写作,虽然支持Markdown语法(使用CommonMark语法),但是在一些额外功能(比如数学公式、表格)的支持上并没有很完善,虽然可以利用pandocmd转换成rst,但是对于数学公式的渲染还是有问题

小结:sphinx适合于发布系列文章,较少的数学公式

Hexo

持续时间: 20191月-至今

现在利用Hexo进行个人博客网站的建设

  1. 对于页面有更强的自定义权限
  2. 没有广告的干扰
  3. 能够快速的进行文章的编辑和发布

个人觉得的一个不方便之处就是它提供了许多快捷方式(比如块引用/代码引用)来辅助markdown的编写,不利于文章的移植,同时hexo对于资源文件的地址处理也有别于一般markdown的编写习惯