首先说明
gitbook-cli
和GitBook
是两个软件
-
gitboo-cli
GitBook 的命令行工具
- 用于安装和管理 GitBook 版本,会自动安装更新所需版本
- 通过
gitbook-cli
安装的GitBook
默认在~/.gitbook
目录可设置
GITBOOK_DIR
环境变量来指定安装目录
-
GitBook
命令行工具可借助 GitHub/Git 和 Markdown 或 AsciiDoc 来编写样式美观的书籍
-
$ npm install -g gitbook-cli
-
$ gitbook --help
输出 gitbook-cli 的帮助信息$ gitbook fetch 标签/版本号
安装指定版本的 gitbook$ gitbook fetch beta
安装pre-release版本
$ gitbook ls
列出本地所有版本的gitbook$ gitbook ls-remote
列出远程所有版本的gitbook$ gitbook update
更新最新版本的gitbook$ gitbook uninstall 2.0.1
卸载对应版本的gitbook
仅安装 gitbook-cli 而未安装 GitBook,如果执行gitbook命令,会自动调用gitbook-cli工具来安装gitbook
-
$ gitbook fetch 标签/版本号
通过gitbook-cli安装指定版本
-
$ gitbook -h
列出gitbook所有的命令$ gitbook init
初始化生成必须文件README.md、SUMMARY.md,并根据SUMMARY生成目录结构$ gitbook build
:在_book
文件夹,生成静态网页--gitbook=2.0.1
指定gitbook版本生成, 本地没有会先下载--log=debug
指定log的级别--debug
输出错误信息
$ gitbook serve
生成静态网页并运行服务在http://localhost:4000/$ gitbook install
安装插件