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
这是我运行成功后的截图