生成一份在线电子书

偏执的太偏执、 2022-09-12 10:47 157阅读 0赞

### 文章目录 ###

*  前言
 *  一、前提了解
 *  二、环境准备
 *  三、动手操作
 *  四、总结

--------------------

# 前言 #

最近在写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>#切换版本

1.  安装gitbook

npm install -g gitbook-cil

<table> 
 <thead> 
  <tr> 
   <th>命令</th> 
   <th>解释</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>gitbook help</td> 
   <td>列出gitook所有的命令</td> 
  </tr> 
  <tr> 
   <td>gitbook build</td> 
   <td>生成静态网页</td> 
  </tr> 
  <tr> 
   <td>gitbook serve</td> 
   <td>生成静态网页并运行服务器</td> 
  </tr> 
  <tr> 
   <td>gitbook ls</td> 
   <td>列出本地gitook所有版本</td> 
  </tr> 
 </tbody> 
</table>

**Gitbook项目结构**  
Gitbook使用简单的目录结构。在SUMMARY中列出所有Markdown文件都会转为HTML。  
![来源于互联网][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_7_color_FFFFFF_t_70_g_se_x_16_pic_center]

<table> 
 <thead> 
  <tr> 
   <th>文件</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>book.js</td> 
   <td>配置数据</td> 
  </tr> 
  <tr> 
   <td>README.md</td> 
   <td>电子书的前言</td> 
  </tr> 
  <tr> 
   <td>SUMMAEY.md</td> 
   <td>电子书目录</td> 
  </tr> 
 </tbody> 
</table>

1.  [安装Typora][Typora]

# 三、动手操作 #

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

![在这里插入图片描述][9ba1efd09eaf41c1929a94e3eb905e85.png]

*  在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如图所示

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16]

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

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

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_11_color_FFFFFF_t_70_g_se_x_16]![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_14_color_FFFFFF_t_70_g_se_x_16]![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 1]

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

**在GitHub中创建新工程**  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 2]**自行取文件名**  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 3]**在settings中pages任意选择一个主题**  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 4]  
**到Code界面删除配置文件**  
![在这里插入图片描述][3b4e52c24c824d7aaae24b4e0872615b.png]**复制仓库地址**  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 5]  
**Windows端桌面新建一个文件夹，通过doc窗口进入（或进入该文件夹右击点击git bush here）**

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

![在这里插入图片描述][e577e5bfe37d42a8b8fd297596aa295b.png]**将之前gitbook serve生成\_book 文件内容放到该文件**

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

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 6]

# 四、总结 #

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

[Nodejs]: https://nodejs.org/en/blog/release/v10.24.0/
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_7_color_FFFFFF_t_70_g_se_x_16_pic_center]: /images/20220828/fc0beeb36ea14d3eb815a4cca26125cd.png
[Typora]: https://www.typora.io/
[9ba1efd09eaf41c1929a94e3eb905e85.png]: /images/20220828/b78589a1a9dd416794086869a4829954.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/9a9938313f8d4c3aa137ec078720639d.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_11_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/cd53f5fb7b554603b33111ca8a51bb8b.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBATUlSQUNMRV9wY29kZQ==,size_11,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_14_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/f18b0569704b400aac089d308c21ff10.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBATUlSQUNMRV9wY29kZQ==,size_14,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 1]: /images/20220828/ea19ceab54e84a66869491f58f00e304.png
[github]: https://github.com/
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 2]: /images/20220828/0ea59ddfe1654b2798db38a1a6a3495f.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 3]: /images/20220828/b6370bca509940bf82ca277cdc83419b.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 4]: /images/20220828/21639e8f896a4443b995dd5d5b396f79.png
[3b4e52c24c824d7aaae24b4e0872615b.png]: /images/20220828/86b56c4ba7f744b091b2e6e1300ab416.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 5]: /images/20220828/6ab7d35428fc4fa386a48213c21e381d.png
[e577e5bfe37d42a8b8fd297596aa295b.png]: /images/20220828/20cdb167c6e84e51890d7b30da8ece8e.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATUlSQUNMRV9wY29kZQ_size_20_color_FFFFFF_t_70_g_se_x_16 6]: /images/20220828/ff7b52a9112746d98d3c1659a2477245.png