一、环境搭建

1. 安装 Node.js
通过网盘分享的文件：node-v20.10.0-x64.msi
链接: https://pan.baidu.com/s/1xlotaQYmXY3Sz9pdPhAS7Q 提取码: gppw
直接进行安装就可以，不需要修改路径

2.安装 GitBook

$ npm install gitbook-cli -g

3.安装typora环境
通过网盘分享的文件：typora-setup-x64.exe
链接: https://pan.baidu.com/s/1v-ARySJ4jFQMKygm_ayFdg 提取码: 8c5s

二、操作方法

1、初始化操作

gitbook基础命令

生成README.md、SUMMARY.md文件
SUMMARY.md：生成目录信息
README.md：课程介绍内容

2.README.md文件配置

# 课程介绍

* [课程介绍](README.md)
* [案例实践](code/案例实践.md)
* [元素等待](code/元素等待.md)
* [PO模式基本概念](code/PO 模式概念.md)
* [PO模式目录结构](code/PO模式目录结构.md)
  * 项目目录demo
    * [util.py](code/util.py.md)
    * [log_config.py](code/log_config.py.md)
    * [config.py](code/config.md)
    * [run_suite.py](code/run_suite.py.md)
  * [base](code/init.md)
    * [base.py](code/base.py.md)
  * page
    * [`__init__.py`](code/__init__.py.md)
    * [pag_web_login.py](code/pag_web_login.py.md)
  * script
    * [test01_login.py](code/test01_login.md)
  * data
    * [login](code/json.md)

格式为：* [标题名称](加载链接文件路径)
主标题顶格写，子标题前面加一个空格

image.png

~注意：1、gitbook init主需要一次就可以了，每次修改后都需要gitbook build重新生成页面。2、路径最好是相对路径，保证文件没有问题。3、生成的文件是一个_book文件夹，打开index.html文件就可以了~

3.生成效果

image.png

三、markdown语法

1、标题
# 一级标题→

一级标题

## 二级标题→

二级标题

### 三级标题→

三级标题

（最多支持 6 级 ######）
2、文本格式
斜体：*斜体* 或 _斜体_→ 斜体
粗体：**粗体** 或 __粗体__→ 粗体
删除线：~~删除线~~→ 删除线
高亮：==高亮==（部分编辑器支持）→ ==高亮==
3、列表
无序列表：

- 项目1
- 项目2

• 项目1
• 项目2

有序列表：

1. 第一项
2. 第二项

1. 第一项
2. 第二项
   4. 链接与图片
   链接：[文本](链接地址 "悬停提示")
   → 百度
   图片：[图片上传失败...(image-52611d-1751696885918)]
   → https://example.com/logo.png
   5、代码
   行内代码：print("Hello") → print("Hello")
   代码块：
   ``` python
   print("代码块")
   ```
   →

print("代码块")

6、表格
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 单元格 | 单元格 | $100 |
| 内容 | 内容 | $200 |
→

左对齐	居中对齐	右对齐
单元格	单元格	$100
内容	内容	$200

7、任务列表
- [x] 已完成
- [ ] 未完成
→

• 已完成
• 未完成
  7、转义字符
  用 \ 避免符号被解析：
  *不会变成斜体* → 不会变成斜体

三、gitbook基础命令

gitbook init //初始化目录文件
gitbook help //列出gitbook所有的命令
gitbook --help //输出gitbook-cli的帮助信息
gitbook build //生成静态网页
gitbook serve //生成静态网页并运行服务器
gitbook build --gitbook=2.0.1 //生成时指定gitbook的版本, 本地没有会先下载
gitbook ls //列出本地所有的gitbook版本
gitbook ls-remote //列出远程可用的gitbook版本
gitbook fetch 标签/版本号 //安装对应的gitbook版本
gitbook update //更新到gitbook的最新版本
gitbook uninstall 2.0.1 //卸载对应的gitbook版本
gitbook build --log=debug //指定log的级别
gitbook builid --debug //输出错误信息

当前可能造成链接点击服务挑战，可以按照下面进行修改
此时，在_book文件夹内，找到gitbook文件夹，在里面找到theme.js
打开，用文本搜索工具搜索查找
if(m)for(n.handler&&
注意，文本时压缩过的，不要搜索if(m)，那样找不到。
找到后，将 if(m)改成if(false)