gitbook安装与使用

Posted 2020-10-04

本文主要介绍了在windown上通过gitbook editor编辑电子书并通过linux系统gitbook进行静态页面访问的方法。

1. gitbook简介：

　　GitBook 是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书。GitBook支持输出以下几种文档格式：

        静态站点：GitBook默认输出该种格式

        PDF：需要安装gitbook-pdf依赖

        eBook：需要安装ebook-convert

 

2. windows上gitbook editor安装：

　　官网https://www.gitbook.com/editor/下载安装

　　安装完成之后，如果有github账号直接登录。

　　登录后选择本地文档保存路径如下图，然后就可以愉快的编写电子书了。

　　

 

3. linux环境搭建gitbook:

　　a.安装Nodejs  (npm)
 　　官网 https://nodejs.org/en/  下载nodejs源码，采用源码编译安装。

　　tar xvf node-v4.2.4-linux-x64.tar.gz   
　　cd node-v.2.4-linux-x64/lib/node_modules/npm  
　　./configure   
　　make   
　　make install

　　b. 配置nodejs镜像
　　nodejs 镜像配置
　　nodejs 安装完成后，我们就可以开始安装 gitbook 了。但是在安装之前，我们还需要配置一下 nodejs 插件安装的下载镜像地址。因为默认的镜像地址是在国外，需要FQ才可以访问，
　　因此我们需要设置国内的镜像地址。国内的我推荐大家使用阿里巴巴的镜像地址 http://registry.npm.taobao.org 。执行下面的命令，进行配置。

　　npm config set registry http://registry.npm.taobao.org


　　c.gitbook 安装

　　npm install -g gitbook-cli

　　gitbook -V
　　查看gitbook是否安装成功。

4.生成静态页面并远程访问

使用gitbook editor在本地编辑电子书，然后将其上传到gitbookserver（）上（或者直接samba映射到linux系统上）。
然后gitbook serve 上传上来的目录
然后浏览器访问即可  (http://XXXXX:4000)

 

5.end