文章目录
- 前言
- 一、前提了解
- 二、环境准备
- 三、动手操作
- 四、总结
前言
最近在写Python基础课件，无意间发现了一个比较好用的电子书生成工具，因此通过文章记录并分享。
一、前提了解
- gitbook 是使用Github/Git 与Markdown构建漂亮书籍的命令工具
- Markdown推荐使用Typora工具
- windows10
二、环境准备
- 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 installnvm use #切换版本
- 安装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 | 电子书目录 |
- 安装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中可以找到线上地址，互联网即可访问资源
四、总结
- 关于图片的插入，地址需要用相对路径，否则静态化并运行服务器，找不到图片。
- 关于nodejs版本问题，安装最新版本v14还出现了版本不适，导致gitbook命令无法使用。
