GitBook入手

K同学啊

发布于 2019-01-22 11:29:22

5750

发布于 2019-01-22 11:29:22

文章被收录于专栏：明天依旧可好的专栏

1. 前言

事情的起由是最近两天心血来潮想写一本自己的书，经过多番调查最后选定了gitbook这个工具。为了安装好gitbook这个工具踩了不少坑，所以写下这篇博客，希望可以帮助到大家。

2. 准备工作

2.1. 安装Node.js

GitBook 是一个基于 Node.js 的命令行工具，下载安装 Node.js，安装完成之后，你可以使用下面的命令来检验是否安装成功。

$ node -v
v10.15.0

2.2. 安装GitBook

1.输入下面的命令来安装 GitBook。（npm是node.js的一个内置工具）

$ npm install gitbook-cli -g

2.安装完成之后，你可以使用下面的命令来检验是否安装成功。

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

3. 创建书籍

1.首先你需要创建一个文件夹来存放你的书籍文件

$ mkdir mybook

2.进入该目录，初始化gitbook

$ cd mybook
$ gitbook init

3.在初始化完成后，系统会在mybook文件下生成 README. md、SUMMARY. md文件

mybook/
├── README.md
└── SUMMARY.md

4.运行下面的命令在浏览器中浏览你的书籍

$ gitbook serve

你看到如下信息说明你成功了，在浏览器中输入http://localhost:4000进行浏览

Live reload server started on port: 35729
Press CTRL+C to quit ...

info: 7 plugins are installed
info: loading plugin "livereload"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 1 pages
info: found 0 asset files
info: >> generation finished with success in 0.6s !

Starting server ...
Serving book on http://localhost:4000

这是我运行成功后的截图