gitbook使用

GitBook 是一个基于 Node.js 的命令行工具，支持 Markdown 和 AsciiDoc 两种语法格式，可以输出 HTML、PDF、eBook 等格式的电子书。所以我更喜欢把 GitBook 定义为文档格式转换工具

简单来说，GitBook + Markdown + Git 带来的好处有：

• 语法简单
• 兼容性强
• 导出方便
• 专注内容
• 团队协作

使用

1. 安装gitbook模块 npm install -g gitbook-cli

2. 初始化项目 $ gitbook init

• 会生成两个文件

REDEME.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置

3. 编辑SUMMARY.md文件

4.预览 gitbook serve

5.打包 gitbook build (打包后的html需要启动服务，或者放到服务器上，本地会报跨域问题)

当然，build 命令可以指定路径：

$ gitbook build [书籍路径] [输出路径]

serve 命令也可以指定端口：

$ gitbook serve --port 2333

你还可以生成 PDF 格式的电子书：

$ gitbook pdf ./ ./mybook.pdf

生成 epub 格式的电子书：

$ gitbook epub ./ ./mybook.epub

生成 mobi 格式的电子书：

$ gitbook mobi ./ ./mybook.mobi

gitbook build 时提示找不到fontsettings.js

• 在_book目录下，如下代码新建book.json

{
        "plugins": [
                "fontsettings",
                "sharing",
                "lunr",
                "search",
                "highlight",
                "livereload"
        ]
}

image.png