使用gitbook输出本地电子书

使用gitbook输出本地电子书

GitBook 是一款基于 Node.js 开发的开源的工具，可以直接在本地创建电子书项目。

主要步骤

1. 安装Node.js
2. 在要写book的文件夹里git bash here
3. 从npm安装gitbooknpm install gitbook-cli -g
4. 查看是否安装成功gitbook -V
5. 使用gitbook init生成SUMMARY和README
6. 使用gitbook serve在本地生成book
7. 使用浏览器访问http://localhost:4000/即可

安装工具：

win10 PowerShell

可能碰到的错误

错误1：无法加载文件 gitbook.ps1

说明：

无法加载脚本，使用管理员身份运行 PowerShell，
然后输入 set-executionpolicy remotesigned

PS C:\Users\Administrator> set-executionpolicy remotesigned

执行策略更改
执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险，如 https:/go.microsoft.com/fwlink/?LinkID=135170
中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?
[Y] 是(Y)  [A] 全是(A)  [N] 否(N)  [L] 全否(L)  [S] 暂停(S)  [?] 帮助 (默认值为“N”): ?
Y - 仅继续执行操作的下一步骤。
A - 继续执行操作的所有步骤。
N - 跳过此操作并继续执行下一操作。
L - 跳过此操作及所有后续操作。
S - 暂停当前管道并返回到命令提示符。键入“exit”可继续执行该管道。

输入Y即可

首次在计算机上启动 Windows PowerShell 时，现用执行策略很可能是 Restricted（默认设置）。Restricted 策略不允许任何脚本运行。

AllSigned 和 RemoteSigned 执行策略可防止 Windows PowerShell 运行没有数字签名的脚本。

或者选择开发者选项 找到 PowerShel 选择应用，最后重启命令行

错误2：TypeError: cb.apply is not a function

gitbook -V的时候提示TypeError: cb.apply is not a function

说明：

打开polyfills.js文件，找到这个函数 function statFix (orig)

在第62-64行调用了这个函数

fs.stat = statFix(fs.stat)
fs.fstat = statFix(fs.fstat)
fs.lstat = statFix(fs.lstat)

把这三行代码注释掉，再依次调用gitbook -V gitbook init gitbook serve 即可