mkdocs

September 1, 2021

“readthedocs+github开启你的免费markdown博客之旅”

虽然市面上有很多的免费博客或者说个人网站方案,不过不是广告,就是国内无法访问。 其实本人一直都比较喜欢blogger的,不过国内真的不好用啊。 最近几年好多程序员已经开始将github pages当作博客用了,github pages真的是很好的福利没错,不过有点我不习惯的是每次都要自己构建链接才行,不然的话就需要用jekyll主题定义后可以,自动生成,可是每次都要用固定的模板书写才行。 另外还有一个比较可行的方案,就是还是用github写markdown,不过要配合上readthedocs的mkdocs生成内容。这次就可以肆意妄为的书写了,只要放入docs目录下就完全不用管了,他可以自动搞定一切。 下面是一个例子 基于mkdocs构建文档博客demo https://mkdocs-terry.readthedocs.io/en/latest/ 复制这个代码就可以 https://github.com/napoler/mkdocs_terry 还有个福利,就是可以绑定域名啊。 如果没有域名可以去http://www.dot.tk/zh/index.html申请个免费的域名。 只要简单设置就可以拥有自己的独立博客了。 https://readthedocs.org/是一个用来共享文档的网站,用来做博客虽然有点不务正业,不过要是分享知识的话,也是一样的。 好多人建议用Sphinx,这个真的不如mkdocs来的简单易用,反正博客。...

Read More