关于本书的写作

开发

./src 目录为书籍内容的源文件。

_book/ 为 gitbook 编译后的文件所在目录，已经添加至 .gitignore。

只需局部安装 gitbook-cli 即可（全局安装使用的话，也很方便）：

# 目前使用的是 9.7.0 版本
$ nvm use
$ npm install -g gitbook-cli
$ npm install

在项目根目录，启动书籍的编译服务：

$ npx gitbook serve src
# 或者使用已经在 package.json 里面定义好了的命令：
$ npm run s

如果 gitbook-cli 命令找不到或者安装有问题，它会给出下面的常见提示：

You need to install "gitbook-cli" to have access to the gitbook command anywhere on your system.
If you've installed this package globally, you need to uninstall it.
>> Run "npm uninstall -g gitbook" then "npm install -g gitbook-cli"

此时按照它说的，卸载再重新安装即可。

发布 HTML 版本

可以用 gitbook build 来生成静态网页版的书籍。

首先要确保已经有了一个独立的分支 gh-pages。方法：第一次执行了 gitbook build 之后，执行下面的命令来创建 gh-pages 分支：

$ gitbook build src _book
# 创建 gh-pages 分支
$ git checkout --orphan gh-pages
$ git rm --cached -r .

只需要保留 package.json、.gitignore 等必要的文件就可以了。

$ git checkout gh-pages
$ cp -r _book/* .
$ git add --all
$ git commit -m 'publish book'
$ git push origin gh-pages

统计字数

关心的是 src 目录下的字符数。主要用到的命令是 find 与 wc，给 wc 指定的参数是 -m，表明我们关心的是字符数。

$ find . -type f -name "*.md"  | xargs wc -m

制作PDF书籍

除了发布 HTML 静态文件，也可以使用命令行工具 ebook-convert 来编译为 PDF。ebook-convert 是 Calibre 发布的一款开源工具。

使用步骤：

• 下载 Calibre 并且安装，calibre-3.40.1，下载地址：官网
• 软连接：ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
• gitbook pdf