markdown转HTML,目录生成
1.首先,准备好已经编辑好的markdown文件放到指定目录下。
2.下载node.js,下载地址:https://nodejs.org/en/download/
3.下载好node.js文件后,配置好环境变量,然后安装gitbook,使用命令:
npm install gitbook-cli -g
4.使用 cd 命令到指定的目录下,输入命令初始化该目录:
gitbook init
等待一段时间之后,会在指定目录下会生成 SUMMARY.md 和 README.md 文件,编辑SUMMARY.md生成目录,如:
* [简介](README.md) * 分布式消息队列 * [1.接入申请流程](分布式消息队列/接入申请流程.md) * [2.专业术语](分布式消息队列/专业术语.md) * [3.网络部署图](分布式消息队列/网络部署图.md) * [4.关键特性及应用场景](分布式消息队列/关键特性及应用场景.md) * [5.使用注意事项](分布式消息队列/使用注意事项.md) * 分布式缓存 * [1.分布式缓存概述](分布式缓存/分布式缓存概述.md) * [2.分布式缓存关键数据类型](分布式缓存/分布式缓存关键数据类型.md) * [3.分布式缓存接入注意事项](分布式缓存/分布式缓存接入注意事项.md) * [4.分布式缓存-申请流程](分布式缓存/分布式缓存-申请流程.md) * MVC * [1.MVC介绍](MVC/MVC介绍.md) * [2.Demo快速搭建](MVC/后端快速搭建.md)
5.在指定目录下输入:
gitbook serve
.成功开启html服务结果:
$ gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...
info: 7 plugins are installed
info: loading plugin "livereload"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 21 pages
info: found 215 asset files
info: >> generation finished with success in 5.3s !
Starting server ...
Serving book on http://localhost:4000
在本地浏览器打开 http://localhost:4000 即可看到html文件
6.如果想将文件打包部署,使用如下命令,会在该目录下生成 _book
目录,即一个完整的HTML静态网站文件包(可以将该文件包部署到网站上)。
gitbook build