win10下安装gitbook，介绍gitbook的一些基础操作…

GitBook安装与卸载

卸载gitbook

windows找到C:\Users\{User}\.gitbook,删除此文件夹。

删除后执行以下命令：

1
2
3
npm uninstall -g gitbook
npm uninstall -g gitbook-cli
npm cache clean -f

安装gitbook

准备环境有Node.js和npm

安装Node.js

GitBook 是一个基于 Node.js 的命令行工具，下载安装 Node.js，安装完成之后，你可以使用下面的命令来检验是否安装成功:

1
2
$ node -v
v12.16.1

安装gitbook

1
2
npm install gitbook-cli -g
gitbook -V

等待安装完成后，再次检验:

1
gitbook -V

Issue1:

1
2
3
4
5
6
7
8
PS C:\Users\Administrator> gitbook -v
gitbook : 无法加载文件 C:\Users\Administrator\AppData\Roaming\npm\gitbook.ps1，因为在此系统上禁止运行脚本。有关详细信息
，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。
所在位置 行:1 字符: 1
+ gitbook -v
+ ~~~~~~~
    + CategoryInfo          : SecurityError: (:) []，PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

Answer1:

1
2
3
4
1.Start Windows PowerShell with the "Run as Administrator" option. Only members of the Administrators group on the computer can change the execution policy.

2. Enable running unsigned scripts by entering:
    set-executionpolicy remotesigned

gitbook使用

1
gitbook init

可以看到创建README.md和SUMMARY.md这两个文件，README.md应该不陌生，就是说明文档，而SUMMARY.md其实就是书的章节目录，其默认内容如下所示：

1
2
3
# Summary

* [Introduction](README.md)

输入gitbook serve，然后在浏览器中输入http://localhost:4000便可预览书籍。

  • 导出PDF: gitbook pdf .
  • 导出epbu: gitbook epub.或者gitbook epub ./ ./mybook.epub