mdbook

一. 网址参考

　　1. 指南- mdBook 文档

　　2. mdBook使用

　　3. 基于Markdown格式的电子书生成工具大比拼：gohugo、mdbook和peach

二. 实践

　　　　主要参考：指南- mdBook 文档

　　1. 安装mdbook

　　　　1.1  安装 Git 版本

mkdir ~/share/new-tech
cd ~/share/new-tech
git clone --depth=1 https://github.com/rust-lang/mdBook.git
cd mdBook
cargo build --release
cp ./target/release/mdbook ~/.bin

　　　　1.2  把/home/cjb/.bin目录加入到PATH环境变量中

　　　　1.3 运行mdbook help命令，验证是否安装成功

　　2. 创建新书　

　　2.1  mdbook init

mkdir /home/cjb/share/book/tech-share
cd /home/cjb/share/book/tech-share
mdbook init

 

 　　2.2  把自己的md文档拷贝到src目录下，并修改SUMMARY.md文件，如：

　　　　

 

 　　

 

 　　2.3 mdbook build

　　

 

　　　结果：会在book目录下生成许多文件

 　　2.4 mdbook serve　

 

 输入命令：

mdbook serve -n 192.168.128.71

         注意：如果不指定-n参数，只能在本机打开，而在192.168.128.102主机上无法通过http://192.168.128.71:3000浏览本书

　　2.5 在浏览器输入http://192.168.128.71:3000则可以浏览本书