GitBook安装、使用与常见问题

概述

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

安装

准备：

node.js
Gitbook
Gitbook编辑器
Calibre

1.安装Node.js

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

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 查看版本

• FQA(常见问题)
  1.导出离线html文件
  2.导出pdf文件
  3.环境依赖版本问题

更多支持，赞赏留言