用轻量云服务器做一个简单的博客,或者说明手册还是非常好的。
现在流行的写博客或者说明手册的语言基本上就算是markdown了。编写规则简单,并且大体上满足基本的写作要求。
目前使用比较火的自己发布博客框架,可能是 mdbook 吧。
本例子主要是使用这个编写了一些使用手册,由于mdbook一般来说需要接入一些统计分析之类的,为了避免重复工作,最好还是在一个模版上来完成这个事情,然后把多本书嵌入进来完成这个需求。
mdbook 的使用手册地址 https://rust-lang.github.io/mdBook/
具体的使用问题比在细说,主要关注于如何在一个主题下编译发布多本书,涉及到使用 python 脚本,很多问题使用 python 脚本还是能够轻松解决的。
新建项目,multibooks
文件结构如下:
接下来修改一下目录结构,想把书都放在books这个文件夹下,对应的 src下也有相应的书的目录,以one、two两本书为例,修改后的文件结构如下:
接下来新建一个 book_template.toml
内容如下:
之后需要做的就是写个脚本替换相应的内容,并且把编译好的结果推送到服务器上去了。
脚本 genBook.py 内容如下:
使用上来说如下:
直接把books整体推送到一个轻量服务器的静态代理地址下,就能愉快的发布多本书了。
可以直接拷贝 仓库地址
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。