关于本书的写作
开发
./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