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