gitbook-cli 命令行操作
gitbook
生成电子书主要有三种方式:gitbook-cli
命令行操作,简洁高效,适合从事软件开发的相关人员.gitbook-editor
编辑器操作,可视化编辑,适合无编程经验的文学创作者.gitbook.com
官网操作,在线编辑实时发布,适合无本地环境且科学上网的体验者.
本文主要讲解第一种
gitbook-cli
命令行操作流程,其他两种见另外两篇教程.本机已安装
node.js
开发环境,安装完成后运 行 gitbook -V
能够打印出版本信息,则表示安装成功.$ sudo npm install -g gitbook-cli
初始化项目,按照
gitbook
规范会自动创建 README.md
和 SUMMARY.md
两个文件,具体用途见下文.其实
SUMMARY.md
是电子书的章节目录,gitbook
会初始化相应的文件目录结构,所以主要是用于开发初始阶段.$ gitbook init
由于能够实时预览电子书效果,并且大多数开发环境搭建在本地而不是远程服务器中,所以主要用于开发调试阶段.
$ gitbook serve
构建静态网页而不启动本地服务器,默认生成文件存放在
_book/
目录,当然输出目录是可配置的,暂不涉及,见高级部分.输出静态网页后可打包上传到服务器,也可以上传到
github
等网站进行托管,因而主要用于发布准备阶段.$ gitbook build
gitbook init
初始化README.md
和SUMMARY.md
两个文件.gitbook build
本地构建但不运行服务,默认输出到_book/
目录.gitbook serve
本地构建并运行服务,默认访问http://localhost:4000
实时预览.
# 创建 `gitbook` 演示项目
$ mkdir gitbook-demo
# 初始化项目
$ gitbook init
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished
# 启动本地服务器
$ gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...
info: 7 plugins are installed
info: loading plugin "livereload"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 1 pages
info: found 0 asset files
info: >> generation finished with success in 1.2s !
Starting server ...
Serving book on http://localhost:4000
# 查看当前目录结构
$ tree
.
├── README.md