1. 安装介绍

这一章主要介绍本地 Gitbook 相关环境的安装,目前主流的平台:Windows、Linux、Unix,Mac OS都是支持的。本地安装需要依赖 Node.js 环境 ,如果需要输出 PDF, eBook,Mobi 等格式的电子书还需要安装 ebook-concert 依赖,好了,下面进入正题!

2. 环境准备

2.1.1. 下载和安装 Node.js

进入上面网站进入选择相关平台下载对应的版本的 Node.js 方法或者安装包,一种是官网根据不同的平台对应的命令来安装,还有一种是下载二进制安装包(笔者推荐方法),进行环境变量配置,本文将介绍笔者的环境安装 Node.js,笔者使用的是Linux Ubuntu环境,使用二进制安装包来安装。

注意: 基于截止到目前的 Gitbook V3.2.3版本,需要使用NodeJs的v10+版本,否则会产生各种报错。 推荐使用:node-v10.24.0-linux-x64

下载 node-v10.24.0-linux-x64 版本的压缩包后,解压到特定的目录,进行环境变量配置。

执行 vim ~/.profile 或者 vim ~/.bashrc 后添加下面的环境变量配置

$ vim ~/.profile
export DART_HOME=TargetPath/node-v10.24.0-linux-x64
export PATH=${DART_HOME}/bin:$PATH

安装完成之后,可以通过下面的命令来验证一下 Node.js 是否安装成功。

$ node -v                                                
v10.24.0

2.1.2. 安装 ebook-concert 依赖

ebook-concert 主要用于生成 PDF、eBook,Mobi 等格式的电子书,具体各平台的下载安装参考官网:https://calibre-ebook.com/download

这里我是使用的Ubuntu平台,执行下面的命令即可:

sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin

安装完成之后,可以通过下面的命令来验证一下 ebook-concert 是否安装成功。

$ ebook-convert --version
ebook-convert (calibre 5.13.0)
Created by: Kovid Goyal <kovid@kovidgoyal.net>

3. 安装 gitbook-cli

执行安装命令, 可参考:https://www.npmjs.com/package/gitbook

$ npm config set registry http://registry.npm.taobao.org   // 可选,设置一下淘宝镜像
$ npm install gitbook-cli -g

安装完成之后,可以通过下面的命令来验证一下 Gitbook 是否安装成功。

$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3

看到正确的输出版本信息,到此就完成了 Ubuntu 平台的 Gitbook 的安装了。

Copyright ©JiangMing all right reserved,licensed by MIT更新时间: 2021-04-10 14:15:03

results matching ""

    No results matching ""