问题描述

GitBook，是一个命令行工具（和Node.js库），用于使用GitHub/Git和Markdown（或AsciiDoc）构建精美的电子书。本文主要介绍如何安装Gitbook工具，以及对应的客户端程序。

该笔记将记录：GitBook 的使用方法，以及相关问题的解决方案。

工具与客户端

GitBook

它一个命令行工具。用于初始化目录，生成文档目录结构，作为Web站点访问文档，导出其他格式等等。

Gitbook Editor

GitBook Editor – Simple writing from your desktop

它是一个桌面编辑器。虽然Gitbook是基于Markdown的，但是编写Markdown还是比较繁琐的。因此可以通过GitBook Editor来编辑笔记。

安装应用

GitBook

# 安装
npm install gitbook-cli -g

# 在当前目录初始化，并创建一个样板
gitbook init

Gitbook Editor

# 下载
# https://legacy.gitbook.com/editor

# 安装：Debian
dpkg -i gitbook-editor-7.0.12-linux-x64.deb

# 启动
gitbook-editor

# 其他方面：
#（1）可以修改「库」（相当于工作目录，是文档的保存目录，新建文档都位于该目录中）的路径：
# 「Menu Bar」-「GitBook Editor」->「Change Library Path...」

参考文献

Setup and Installation of GitBook
Libraries.io/gitbook
GitBook/What is GitBook
gitbook安装中installing gitbook xxx 时间过长的问题