Gitbook初体验

快来打我* 2021-10-31 16:42 561阅读 0赞

#### 安装 ####

GitBook 是一个基于 Node.js 的命令行工具，安装Node.js

sudo apt install nodejs

查看版本

node -v

安装npm,(说实话还是没搞懂这是啥。不过感觉像是一个安装工具）

sudo apt install npm

出现错误,错误是缺少依赖包，

Reading package lists... Done
    Building dependency tree       
    Reading state information... Done
    Some packages could not be installed. This may mean that you have
    requested an impossible situation or if you are using the unstable
    distribution that some required packages have not yet been created
    or been moved out of Incoming.
    The following information may help to resolve the situation:
    
    The following packages have unmet dependencies:
     npm : Depends: node-gyp (>= 0.10.9) but it is not going to be installed
    E: Unable to correct problems, you have held broken packages.

按照提示安装依赖包即可，当时就装了这几个依赖

sudo apt-get install nodejs-dev node-gyp libssl1.0-dev

安装Gitbook

sudo npm install gitbook-cli -g

记得加`sudo`，没加会出错  
好啦，安装到此结束。接下来该使用啦！  
首先建立一个文件夹，然后初始化

mkdir book
    cd ~/book
    gitbook init

可以看到文件夹下创建了 README.md 和 SUMMARY.md 这两个文件，README.md 是说明文档，而 SUMMARY.md是书的章节目录。  
将之前写好的××.md文档放置book目录下，再在SUMMARY.md文件中添加相应的目录，二级目录用TAB缩进。或者没有文件时直接在SUMMARY.md中添加相应的目录，在book目录下会创建相应的××.md文件。

执行

gitbook serve

通过 http://localhost:4000 预览电子书内容，预览完毕后按 Ctrl + C 结束。  
`gitbook build`这一句是构建书籍的意思，包含在`gitbook serve`中了。  
生成PDF格式文件

gitbook pdf ./ ./mybook.pdf

生成 epub 格式文件

gitbook epub ./ ./mybook.epub

生成mobi 格式文件

gitbook mobi ./ ./mybook.mobi

报错说缺少 ebook-convert,根据提示安装即可。

sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.py | sudo python -c "import sys; main=lambda:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main()"

Gitbook的基本目录结构

.
    ├── book.json
    ├── README.md
    ├── SUMMARY.md
    ├── chapter-1/
    |   ├── README.md
    |   └── something.md
    └── chapter-2/
        ├── README.md
        └── something.md

book.json:该文件主要用来存放配置信息