fix mdbook issue for workflows

Author: Sunrisepeak

.github/workflows/online-ebook.yml

@@ -40,10 +40,17 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
-      - name: Install mdBook by Xlings
-        run: |
-          curl -fsSL https://d2learn.org/xlings-install.sh | bash
-          xlings install mdbook@${MDBOOK_VERSION} --global -y
+      #- name: Install mdBook by Xlings
+      #  run: |
+      #    curl -fsSL https://d2learn.org/xlings-install.sh | bash
+      #    xlings install mdbook@${MDBOOK_VERSION} --global -y
+      - name: Setup mdBook
+        uses: peaceiris/actions-mdbook@v2
+        with:
+          mdbook-version: '0.4.43'
+
+      - run: mdbook build
+
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v4

README.md

@@ -1,42 +1,31 @@
 # d2x-project-template
 
-> d2x教程类项目模板 - `Book + Video + Code + X`
+> d2x交互式教程项目模板 - `Book + Video + Code + X`
 
 [![d2x](https://img.shields.io/badge/d2x-ok-green.svg)](https://github.com/d2learn/d2x)
 [![License](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](LICENSE-CODE)
 
-该项目提供了一个, 可以被[d2x](https://github.com/d2learn/d2x)工具识别和加载的**交互式**教程类项目结构. 开发者和教程制作者, 可以基于这个模板来设计开发自己的交互式教程项目
+| [d2x工具](https://github.com/d2learn/d2x) - [论坛](https://forum.d2learn.org) |
+| --- |
+| [文档](https://d2learn.github.io/d2x-project-template) -> [工具和环境配置](https://github.com/d2learn/d2x) -> [项目和新内容添加](https://forum.d2learn.org) |
+
+该项目提供了一个, 可以被[d2x](https://github.com/d2learn/d2x)工具识别和加载的**交互式教程项目**的基础结构. 开发者和教程创作者, 可以基于这个模板来设计开发自己的交互式教程项目
 
 ## 功能特色
 
 - 提供了基础的 `Book + Video + Code + X` 结构
 - d2x工具可以直接识别和加载
 - 提供了项目依赖描述, 支持一键配置环境
 
-## 快速开始
-
-**方式一: 本地安装使用**
-
-```
-xlings install d2x@latest
-d2x create d2hello
-cd d2hello
-d2x book
-```
-
-**方式二: 直接使用项目模板**
-
-通过 [Use this template](https://github.com/new?template_name=d2x-project-template&template_owner=d2learn) 创建新的仓库
-
-> 注: 工具安装及环境配置文档 -> [详情](https://d2learn.github.io/d2x-project-template)
-
 ## 具体项目案例
 
 | 项目 | 简介 | 备注 |
 | --- | --- | --- |
 | [d2mcpp](https://github.com/mcpp-community/d2mcpp) | 现代C++核心特性入门教程 | |
+| [d2ds](https://github.com/d2learn/d2ds) | 强调动手实践的数据结构学习项目 | |
 
 ## 其他
 
 - [d2x工具](https://github.com/d2learn/d2x)
-- [论坛交流和反馈](https://forum.d2learn.org)
+- [论坛交流和反馈](https://forum.d2learn.org)
+- `交流群`: 167535744

book/src/SUMMARY.md

@@ -1,6 +1,6 @@
 # Summary
 
 - [简介](./chapter_0.md)
-- [工具安装与环境配置](./chapter_1.md)
-- [配置并添加内容](./chapter_2.md)
-- [等待你的扩展](./chapter_2.md)
+- [工具与环境配置](./chapter_1.md)
+- [项目和新内容添加](./chapter_2.md)
+- [等待你的扩展](./chapter_3.md)

book/src/chapter_0.md

@@ -1,42 +1,32 @@
-# d2x-project-template 简介
+# d2x-project-template
 
-> d2x教程类项目模板 - `Book + Video + Code + X`
+> d2x交互式教程项目模板 - `Book + Video + Code + X`
 
 [![d2x](https://img.shields.io/badge/d2x-ok-green.svg)](https://github.com/d2learn/d2x)
+[![online-ebook](https://img.shields.io/badge/online-ebook-orange.svg)](https://github.com/d2learn/d2x)
 [![License](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](LICENSE-CODE)
 
-该项目提供了一个, 可以被[d2x](https://github.com/d2learn/d2x)工具识别和加载的**交互式**教程类项目结构. 开发者和教程制作者, 可以基于这个模板来设计开发自己的交互式教程项目
+| [d2x工具](https://github.com/d2learn/d2x) - [论坛](https://forum.d2learn.org) |
+| --- |
+| [文档](https://d2learn.github.io/d2x-project-template) -> [工具和环境配置](https://d2learn.github.io/d2x-project-template/chapter_1.html) -> [项目和新内容添加](https://d2learn.github.io/d2x-project-template/chapter_2.html) |
+
+该项目提供了一个, 可以被[d2x](https://github.com/d2learn/d2x)工具识别和加载的**交互式教程项目**的基础结构. 开发者和教程创作者, 可以基于这个模板来设计开发自己的交互式教程项目
 
 ## 功能特色
 
 - 提供了基础的 `Book + Video + Code + X` 结构
 - d2x工具可以直接识别和加载
 - 提供了项目依赖描述, 支持一键配置环境
 
-## 快速开始
-
-**方式一: 本地安装使用**
-
-```
-xlings install d2x@latest
-d2x create d2hello
-cd d2hello
-d2x book
-```
-
-**方式二: 直接使用项目模板**
-
-通过 [Use this template](https://github.com/new?template_name=d2x-project-template&template_owner=d2learn) 创建新的仓库
-
-> 注: 工具安装及环境配置文档 -> [详情](https://d2learn.github.io/d2x-project-template)
-
 ## 具体项目案例
 
 | 项目 | 简介 | 备注 |
 | --- | --- | --- |
 | [d2mcpp](https://github.com/mcpp-community/d2mcpp) | 现代C++核心特性入门教程 | |
+| [d2ds](https://github.com/d2learn/d2ds) | 强调动手实践的数据结构学习项目 | |
 
 ## 其他
 
 - [d2x工具](https://github.com/d2learn/d2x)
-- [论坛交流和反馈](https://forum.d2learn.org)
+- [论坛交流和反馈](https://forum.d2learn.org)
+- `交流群`: 167535744

book/src/chapter_2.md

@@ -1,4 +1,4 @@
-# 配置并添加内容
+# 项目配置和新内容添加
 
 本章节主要是介绍模板项目的基础结构, 以及如何基于模板进行配置和添加自己的内容
 
@@ -124,6 +124,8 @@ git-repository-url = "xxxx"
 - 第一步: 在`book/src`目录添加章节文件, 并填充内容
 - 第二步: 在`book/src/SUMMARY.md`添加这个文件的目录索引
 
+> 注: 更多配置细节参考 - [mdbook文档](https://rust-lang.github.io/mdBook)
+
 ## 三、Code: 添加新的练习代码
 
 项目的练习代码集中放在了`dslings`目录中, 每当用户运行`d2x checker`命令时, 就会自动加载这些练习代码到一个检测队列中, 并跳转到当前第一个检测不同的练习代码, 等待用户去修改和完整.
@@ -238,6 +240,6 @@ d2x工具在练习代码检测过程中, 提供了一个AI智能助手的功能.
 
 ### 配置在线电子书
 
-模板项目默认提供了Github Pages的自动部署功能
+模板项目默认提供了Github Pages的自动部署功能, 只需要打开开启一下即可
 
 具体步骤: `仓库的Setting -> Pages -> Build and deployment -> Source -> Github Actions`