Gitbook 超详细入门！

Gitbook 超详细入门！

Gitbook效果预览

安装

安装 node.js

安装 gitbook

安装了 Node.js 会默认安装 npm（node 包管理工具）

npm install -g gitbook-cli

输入 gitbook -V 查看是否安装成功

安装 Typora

安装 Git

使用方法

创建放置文档的仓库

在电脑中创建一个 Gitbook 文件夹，用于放置自己的 Gitbook 文件。

再在 Gitbook 文件夹中创建新的文件夹，以 bookname 命名。

初始化

到 bookname 文件夹中打开 powershell 窗口，执行gitbook init命令。

坑：在此系统禁止运行脚本

此处若失败并出现提示信息“因为在此系统禁止运行脚本”，需要以管理员身份打开power shell，输入set-ExecutionPolicy RemoteSigned，选择“是”。

编辑

接下来打开 Typora，文件 - 打开文件夹 - 选择 bookname 文件夹，编辑 SUMMARY.md 文件以修改大纲。

修改后，打开 power shell，输入 gitbook init，bookname 文件夹内就会生成对应的 md 文件。

预览

执行 gitbook serve 来预览这本书籍。

坑：Error: ENOENT: no such file or directory

用户目录下找到文件 .gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js，将所有的 confirm: true 语句改为 confirm: false

之后打开 http://localhost:4000 预览。

生成静态网站

执行 gitbook build 命令，默认将生成的静态网站输出到 _book 目录。

用 Git 做版本管理

1. 在 Github 创建好仓库
2. 在 bookname 目录下执行 git init初始化本地仓库
3. git remote add origin git@server-name:path/repo-name.git关联远程仓库。
4. 关联后，使用命令git push -u origin master第一次推送master分支的所有内容。

关联 Gitbook

进入 Gitbook，用 Github 账号登录。

选择 Create a new space

点击 Intergrations

选择 Github

连接 Github 仓库

选择要同步的仓库

同步成功

复制地址即可供他人访问

也可在此修改域名

高阶 Gitbook 命令

生成 PDF gitbook pdf ./ ./mybook.pdf

生成 epub 格式的电子书 gitbook epub ./ ./mybook.epub

生成 mobi 格式的电子书 gitbook mobi ./ ./mybook.mobi