关于本书的写作

开发

./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 目录下的字符数。主要用到的命令是 findwc,给 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