[Gitbook]简单使用

gitbook 备忘， 具体见参考中的文档

GitBook 是基于 Node.js 的开源命令行工具,支持Markdown和AsciiDoc语法，可以输出html，pdf，epub，mobi等众多电子书格式。

GitBook和gitbook.com不是一个东西， gitbook是开源免费的电子书文档构建工具， gitbook.com是商业化的提供文档知识库服务的网站， 提供了简单高效的图书在线撰写、发布和托管方案， 你可以通过gitBook.com进行在线编辑，发布，分享。 gitBook.com 提供的服务对个人用户免费，但是商业版权比较贵。

安装

安装命令行接口程序

1

npm install gitbook-cli -g

或者查看可用版本， 下载指定版本

1
2

gitbook ls-remote 
gitbook fetch <version>

查看版本信息, 检测安装成功

1

gitbook --version/-V

如果没有版本可用, 会自动下载最新版gitbook
这里可能会出现cb.pply is not a function，或者其他 Cannot find module ‘internal/util/types’， 都是因为node版本太高不兼容导致的， 我一开始用的18.16.0， 用nvm换了好几个版本， 最后用10.23.1版本再下载就可以了.

使用

1
2
3

gitbook init
gitbook build
gitbook serve

直接gitbook serve 也会先build

gitbook install 插件下载速度慢, 可以直接用npm install gitbook-plugin-xxx

参考

1. gitbook-template简易教程
2. mapull码普gitbook说明文档
3. gitbook官方文档
4. gitbook文档