(GitBook安装与使用)

概述

Gitbook是一个开源免费软件，它使用 Markdown 语法来编排书本，同时也支持HTML语法。

安装

准备：

node.js
Gitbook
Gitbook编辑器
Calibre

1.安装Node.js

安装校验。输入 node -v,显示node.js版本代表安装成功。

Node安装成功

2.npm指令安装gitbook

sudo npm install gitbook -cli -g

3.安装Gitbook Editor

Gitbook编辑器是支持markdown语法，可以进行E-Book编写的可视化的客户端软件。
安装终端环境的GitBook只是为了生成HTML文档与PDF文档使用。
安装了Gitbook桌面端之后，可以在客户端中新建一本书籍。然后用终端生成HTML。

使用gitbook build 命令
系统文件根目录下就生成了一个_book的文件夹。打开就是该书籍的HTML格式了。

使用gitbook serve命令
可以直接将该书籍在本地预览

导出PDF等格式文件
基于是否愿意公开文档至gitbook或者github仓库。可以选择不同的工具或者网站，进行格式文件输出。
1.Gitbook网站上可以直接导出PDF，MOBI，EBUP等电子书格式。
2.使用终端生成PDF等格式文件。需要安装calibre插件(如果不想将书籍公开)

4.安装calibre插件

calibre是一款非常方便的开源电子书转换软件。我们也是用到ebook-convert这个插件功能。
下载安装calibre

• 将app添加到path中

sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

• 转pdf文件操作

gitbook pdf sourceFilePath targetFilePath/FileName.pdf

插件安装与使用

- 搜索、页脚、分页...

More

• 环境依赖

1.Components
> nvm、node、nom
- nvm  
- node 
- npm
2.Interdependence

• gitbook常用操作

1.git init
2.gitbook bulid 
3.gitbook serve
4.gitbook build --gitbook=3.2.3
5.gitbook ls 
6.gitbook pdf SourceFilePath TargetFilePath/FileName.pdf
7.<br>

• FQA(常见问题)
  1.导出离线html文件
  2.导出pdf文件
  3.环境依赖版本问题
  4.gitbook build --gitbook=2.6.7报错
  截屏2020-11-26 下午10.21.32.png
  4.1 原因：
  由于node版本（具体不详），由于本人没有安装成功
  4.2 方式：

1.安装node管理 n
sudo npm install -g n
2.降低版本，更新npm
sudo n 6
sudo npm install npm -g
3.此时运行gitbook2.6.7的命令即可。
gitbook build --gitbook=2.6.7
4.待转换完成后，将npm版本（例如9.10.0）切回来即可,以免影响其他模块
sudo n 9.10.0
参考
gitbook打包后点击链接报错(不完整)
https://blog.csdn.net/qq_39186346/article/details/90044868

更多支持，赞赏留言👇