Gitbook----基于 Windows 10 体系当地安装配置 Gitbook 编写属于自己的电子
查看原文一、安装 Nodejs
若要在 Windows 10 体系即当地使用 Gitbook，必要安装 gitlab-cli 工具，而 gitbook-cli 工具是基于 Nodejs的，因此首先必要安装 Nodejs
如果是初学者，可以参考 Nodejs----基于 Windows 10 体系安装 Nodejs 安装 Nodejs，这里必要注意，本文验证过安装 16.20.1 版本的 Nodejs是可以的，因此这里建议也安装 16.20.1 版本，不要安装更高的版本，如果手头上涉及多个前端项目，那么本文这里还是直接推荐参考 nvm----在 Windows10 体系同时安装管理多个Nodejs版本并能进行机动便捷的切换工具 通过安装nvm，从而可以在 Windows 体系上安装多个 Nodejs 版本，这样在后续项目开发中可以做到机动切换 Nodejs 的版本。本文就以 nvm 工具的方式演示
二、安装 Gitbook
（1）首先通过 nvm 查看当地已经安装了的 Nodejs 的版本，如下，这里已经安装了三个版本
https://i-blog.csdnimg.cn/blog_migrate/7b3136bda01ff0c27da73c78ace20667.png
（2）因此这里可以通过 nvm use 16.20.1 下令切换 Nodejs 的版本，切换完成后，再次查看，如下确认 Nodejs 版本已经切换到 16.20.1 版本了。
https://i-blog.csdnimg.cn/blog_migrate/2f4a31ac581d776ca5af706b501df68f.png
（3）然后即可开始安装 gitbook-cli 包了，执行如下下令
npm install gitbook-cli -g
（4） 然后执行如下下令查看 gitbook-cli 的版本号并安装 gitbook
gitbook -V
（5） 此时有可能会出现如下错误，如果没有出现则直接跳过本步调，如果出现了如下错误，则必要去解决一下。
https://i-blog.csdnimg.cn/blog_migrate/9ea8aae69b9e60df03b24a7b08c17797.png
根据这里的报错提示，去打开 D:\ProgrameFile\nvm\v16.20.1\global\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js 文件，找到287行代码，可以看出如果有调用 statFix 函数则会触发这个问题。
https://i-blog.csdnimg.cn/blog_migrate/7cd7220c6df20cb4d784ba1eba6902a2.png
在这个文件中搜刮 staFix 函数调用的位置，如下所示，只有如下三行在调用
https://i-blog.csdnimg.cn/blog_migrate/7232d144cd9748c345d4fc8571a4d53f.png
这里也在网上查询了一些资料，发现很多多少人遇到过此问题，而且反馈只必要将此三行注释掉即可，因此这里我们同样也将此三行代码注释掉，如下图所示。
https://i-blog.csdnimg.cn/blog_migrate/351d8dd3e01b72e699f197d5edffb1a1.png
然后保存，再此执行 gitbook -V
下令，如下图所示，可以看到已经安装乐成了。
https://i-blog.csdnimg.cn/blog_migrate/6829b887397f2f422bec930a02dc6dda.png
三、gitbook 的使用方法
（1）这里就以 https://github.com/redrose2100/docs 代码仓为例展示了，将此 docs 项目下载到当地后，比如想写一本关于 Linux 的电子书，这里在 docs 项目中新建一个文件夹 linux，用于存放即将编写的电子书。目录结构如下所示：
https://i-blog.csdnimg.cn/blog_migrate/63e20eabb33a9bcff6cf39df837c6fa7.png
（2）在cmd窗口中进入到 linux 的文件夹，然后执行 gitbook init 下令，这里又遇到了如下所示的错误。
https://i-blog.csdnimg.cn/blog_migrate/8373159dc8735b0954598185c36b7bc8.png
此时必要找到文件 C:\Users\Administrator.gitbook\versions\3.2.3\lib\init.js，然后将 72 行注释掉，然后修改为 73行的代码
https://i-blog.csdnimg.cn/blog_migrate/7324d494f2b5658e1ae759e3ee99da1c.png
即将
return fs.writeFile(filePath, summary.toText(extension));
修改为：
return summary.toText(extension).then(stx=>{return fs.writeFile(filePath, stx);});
保存后，重新执行 gitbook init 下令，此时可以看到可以执行乐成了。
https://i-blog.csdnimg.cn/blog_migrate/3fe473c73faf708dd22315ce5f3ab8ac.png
（3）此时会新生成两个文件 README.md 和 SUMMARY.md，目录结构如下图所示：
https://i-blog.csdnimg.cn/blog_migrate/4926c13958071f2487f2a850e092457d.png
（4）此时临时先不做任何修改，然后直接执行 gitbook serve 下令启动服务，如下图所示：
https://i-blog.csdnimg.cn/blog_migrate/b359fe7407aa16950b6e72d6bb68a443.png
（5）根据提示然后在浏览器中打开 http://localhost:4000/ ，即可打开电子书的页面了，如下图所示：
https://i-blog.csdnimg.cn/blog_migrate/134d93fa1db5ad53d74dac8f3a159b21.png
四、计划电子书的目录结构
首先必要规划一下电子书的目录结构，比如我们想写一本关于Linux的电子书，然后大概计划如下目录：
第一章 Linux 概述
1.1 Linux 简介
1.2 Linux 特点
1.3 Linux 的发展历史
第二章 Linux 常用命令
2.1 用户与权限管理命令
2.2 文件管理命令
2.3 磁盘管理命令
第三章 shell 编程
3.1 条件语句
3.2 循环语句
3.3 shell 编程实例
（1）首先在 linux 文件下创建三个文件夹，比如 ch01、ch02、ch03，用于存放三章内容，然后在每一个创建的子文件夹中继续创建md文件，比如 ch01/1_1.md, ch01/1_2.md, ch01/1_3.md, ch02/2_1.md, ch02/2_2.md, ch02/2_3.md, ch03/3_1.md, ch03/3_2.md, ch03/3_3.md, 此时的文件目录结构如下图所示：
https://i-blog.csdnimg.cn/blog_migrate/697ce9481309bc337ff3603bc9f7400c.png
（2）linux/README.md 文档可以明确为电子书的前言，而 SUMMARY.md 则是目录文件，这里比如先将 README.md 文档内容修改为如下内容：
# 前言
这是一本关于 Linux 的技术实战类型的书籍
（3）然后重点就是写 SUMMARY.md 文档，即编写目录了，这里根据电子册本规划目录，可以编写 SUMMARY.md 文件的内容如下：
# 目录
* [前言](README.md)
* [第一章 Linux 概述]()
* (ch01/1_1.md)
* (ch01/1_2.md)
* (ch01/1_3.md)
* [第二章 Linux 常用命令]()
* (ch02/2_1.md)
* (ch02/2_2.md)
* (ch02/2_3.md)
* [第三章 Linux shell 编程]()
* (ch03/3_1.md)
* (ch03/3_2.md)
* (ch03/3_3.md)
（4）将 gitbook serve 下令停止，然后重新执行 gitbook serve 下令，然后再根据提示打开 http://localhost:4000/ ，效果如下图所示，可以看出，此时已经和我们心中想象的电子书的格式差不多了。
https://i-blog.csdnimg.cn/blog_migrate/c55555680940b020bed814302ae50e37.png
五、设置 gitbook 常用配置
（1）在linux 文件夹即与 SUMMARY.md 同一目录下创建 book.json 文件，文件内容如下所示：
{
"title": "Linux 从入门到精通",
"author": "redrose2100",
"description": "Linux 从入门到精通",
"language": "zh-hans",
"gitbook": "3.2.3",
"links": {
"sidebar": {
"GitHub": "https://github.com/redrose2100/docs"
}
}
}
此中：
[*]title：书名
[*]author：作者
[*]description： 扼要描述
[*]language： 语言，这里使用 zh-hans 可以将页面切换为中文
[*]gitbook： gitbook 的版本号，在安装的时间可以看到
[*]links.sidebar： 可以设置连接，比如设置github链接调转到 docs 代码堆栈地址
（2）再一次重新执行 gitbook serve 下令，然后重新打开 http://localhost:4000/ ，如下图所示，此时页面上原本英文的全部切换为中文了，而且在左侧还增加了一个 Github 链接，点击后是可以跳转到 github 上 docs 代码仓的。
https://i-blog.csdnimg.cn/blog_migrate/eebc93bf52250bf6b26ccf481f24ff5f.png
至此，在Windows上就将gitbook乐成的运行起来了，当然为了能够编写出更加丰富多彩的电子书，后续还有很多功能比如常用的插件、比如屏蔽不必要的信息等，都必要继续进一步去优化，后续优化将在其他文章中继续具体展开，这里就临时不在展开了。
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]