生成一份在线电子书

---

前言

最近在写Python基础课件，无意间发现了一个比较好用的电子书生成工具，因此通过文章记录并分享。

---

一、前提了解

1. gitbook 是使用Github/Git 与Markdown构建漂亮书籍的命令工具
2. Markdown推荐使用Typora工具
3. windows10

二、环境准备

1. Nodejs【推荐下载v10+，v14出现了cb.apply is not function 问题；这里用的是V10.24.0】

#安装好验证版本
Node -v


#以下是提供给多版本切换使用的命令
#安装nvmw 便于node版本切换
npm install -g nvmw
#nvmw 一些命令
nvmw -h #帮助
nvmw -v #版本
nvm install <version>
nvm use <version>#切换版本

2. 安装gitbook

npm install -g gitbook-cil

命令	解释
gitbook help	列出gitook所有的命令
gitbook build	生成静态网页
gitbook serve	生成静态网页并运行服务器
gitbook ls	列出本地gitook所有版本

Gitbook项目结构
Gitbook使用简单的目录结构。在SUMMARY中列出所有Markdown文件都会转为HTML。

文件	描述
book.js	配置数据
README.md	电子书的前言
SUMMAEY.md	电子书目录

3. 安装Typora

三、动手操作

• 在文件夹新建两个文件夹如下

• 在summary中内容输入如下

#REAME.md--书籍的介绍写在这里文件
#SUMMARY.md--书籍的目录结构在这里配置
# 目录
 * [前言](README.md)
 * [第一章](Python基本语法元素/README.md)
 * [第二章](Python基本图形绘制/README.md)
 * [第三章](基本数据类型/README.md)
 * [第四章](程序的控制结构/README.md)
 * [第五章](函数的代码和复用/README.md)
 * [第六章](组合数据类型/README.md)
 * [第七章](程序设计方法/README.md)
 * [第八章](python计算生态/README.md)

• demo如图所示

• doc窗口进入该文件下输入以下命令

#进入到目录文件夹输入以下命令
#gitbook初始化
gitbook init
#静态初始化并运行服务器
gitbook serve

• 结果如下（crtl+c 停止服务器运行）

• 关联github进行静态资源联网化
  • 自己申请GitHub账号
  • 安装好git工具

在GitHub中创建新工程
自行取文件名
在settings中pages任意选择一个主题

到Code界面删除配置文件
复制仓库地址

Windows端桌面新建一个文件夹，通过doc窗口进入（或进入该文件夹右击点击git bush here）

git clone https://github.com/nickwang6/demo.git

将之前gitbook serve生成_book 文件内容放到该文件

#第一次还需要邮箱进行验证
#这里只用了index.html文件
#初始化文件
git init
#添加文件到暂存区
git add.
#将暂存区内容添加到仓库中。
git commit "备注信息"
#提交
git push

可以在settings -pages中可以找到线上地址，互联网即可访问资源

四、总结

1. 关于图片的插入，地址需要用相对路径，否则静态化并运行服务器，找不到图片。
2. 关于nodejs版本问题，安装最新版本v14还出现了版本不适，导致gitbook命令无法使用。