前言
最近在写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 install <version>
nvm use <version>#切换版本
- 安装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 | 电子书目录 |
三、动手操作
- 在文件夹新建两个文件夹如下
- 在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命令无法使用。