mdbook通过markdown制作电子书(代替gitbook)

环境：

mdbook: v0.4.28

前言

gitbook制作电子书大家已经非常熟悉了，但是对于gitbook工具官方已经不再维护了，而且环境搭建也略微负载。

本文介绍一款gitbook的替代工具mdbook。

mdBook是一款通过Markdown制作电子书的命令行工具，功能上与 Gitbook类似。mdBook适合制作在线书籍、产品或API文档、教程、课程材料、开源书籍等等。

1. 安装mdbook

• 二进制单文件安装

到github直接下载所需的二进制文件，配置到环境变量即可。

https://github.com/rust-lang/mdBook/releases

• cargo安装

需要安装号Rust环境

cargo install mdbook

2. mdbook的基本使用

• 初始化

$ mdbook init mybook

Do you want a .gitignore to be created? (y/n)

What title would you like to give the book?
mybook

All done, no errors...

$ ls mybook/
book/  book.toml  src/

• web服务中浏览电子书

$ mdbook serve
[INFO] (mdbook::book): Book building has started
[INFO] (mdbook::book): Running the html backend
[INFO] (mdbook::cmd::serve): Serving on: http://localhost:3000
[INFO] (warp::server): Server::run; addr=[::1]:3000
 [INFO] (warp::server): listening on http://[::1]:3000
[INFO] (mdbook::cmd::watch): Listening for changes...

• 生成html静态文件

可以在book目录生成html静态文件

$ mdbook build
[INFO] (mdbook::book): Book building has started
[INFO] (mdbook::book): Running the html backend

---

Reference:

1. https://github.com/rust-lang/mdBook