aopstudio 的个人博客   >   标签墙   >   Markdown 标签

使用 docsify 并定制以使它更强大

2022-02-19

背景 经常在网上看到一些排版非常漂亮的技术手册,左边有目录栏,右边是Markdown格式的文档,整个配色都十分舒服,就像一本书一样,一看就很让人喜欢。就比如Markdown Preview Enhanced的文档.目前网上我了解的有两种工具可以实现这样的效果,一种叫做docsify,另一种叫做Gitbook。因为MPE文档用的是docsify,而且据docsify自己的宣传,说是 不同于 GitBook、Hexo 的地方是它不会生成将 .md 转成 .html 文件,所有转换工作都是在运行时进行。 这将非常实用,如果只是需要快速的搭建一个小型的文档网站,或者不想因为生成的一堆 .html 文件“污染” commit 记录,只需要创建一个 index.html 就可以开始写文档而且直接部署在 GitHub Pages。 所以我也就用它来做吧。这里先放上我的成品:https://aopstudio.github.io/docs 入门基础 具体的一些基本操作它的官方文档上面都已经写得很明白了,我就不再赘述了,官方文档地址:https://docsify.js.org/#/zh-cn/ 。....

在 Markdown 中使用数学公式

2022-02-19

背景 $\TeX$是一款经典的文本排版软件,由计算机科学界的巨匠高德纳(Donald E. Knuth)开发。高德纳有一套著名的书籍叫做《计算机程序设计的艺术》,他在写这本书的时候觉得当时其他的排版工具的效果都不能让自己满意,于是就自己开发了一套排版工具。这让我想到Ken Thompson和Dennis Ritchie为了玩一个游戏而开发出了Unix操作系统,然后为了继续完善Unix操作系统而开发出了C语言的故事,简直如出一辙。大神们总能做出一些平常人想都不敢想的事情。 $\TeX$可以为一整篇文献排版出非常漂亮整洁的效果,尤其对于数学公式的支持特别好,因此在学术界,特别是理工学界非常通用,IEEE等著名学会都要求以$\TeX$格式提交论文。我曾经尝试使用了一下,感觉排版出来的效果真的是非常专业,但是如果只是写短篇笔记的话和Markdown比起来速度慢很多,于是我还是选择了Markdown作为写笔记的工具。但是原生的Markdown是不支持数学公式的,而我作为理工科的学生经常需要记下数学公式,不过Markdown可以通过扩展语法的方式来使用$\TeX$语法的数学公式,很多Markdow....

使用 Gitalk 实现静态页面评论的功能 有更新!

2022-02-19

使用静态页面的理由 本人在Github上使用github.io部署了一个静态主页,地址是http://aopstudio.github.io,用于存放一些笔记文件。虽然静态页面功能少,自动化程度低,不过github.io的优点在于页面完全随自己设计,html,css和javascript全部随由自己安排,同时不需要自己的服务器资源。而且不少Github用户都会设置github.io作为自己的展示页面,也算是一个潮流。 更大的理由——Markdown Preview Enhanced插件太强大。。。 我使用的Markdown写作工具是VS code搭配其中的Markdown Preview Enhanced插件,功能相当强大,尤其是其中的脚本语言画图像的功能让我爱不释手。在该插件内可以使用脚本语言(比如DOT语言)画出矢量图,包含流程图、时序图、有向图、无向图等等,目前我还没有发现其他Markdown渲染工具可以达到相同的功能。Github中的Markdown语言据说是对原生Markdown进行了功能增强,但是连$\TeX$公式都不支持,和MPE插件比起来更是差了十万八千里(这里要夸一下....