add multi language support (#3)

* add multi language support

- mcpp-community/OpenOrg#1

Signed-off-by: sunrisepeak <speakshen@163.com>

* update

* update

* Update book/build.sh

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update xmake.lua

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Signed-off-by: sunrisepeak <speakshen@163.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: Sunrisepeak

.github/workflows/online-ebook.yml

@@ -50,15 +50,13 @@ jobs:
       #  with:
       #    mdbook-version: '0.4.43'
 
-      - run: mdbook build
-
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v4
       - name: Build with mdBook
         run: |
           export PATH=/home/xlings/.xlings_data/bin:$PATH
-          mdbook build
+          ./build.sh
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:

README.md

@@ -1,40 +1,40 @@
 # d2x-project-template
 
-> d2x交互式教程项目模板 - `Book + Video + Code + X`
+> d2x Interactive Tutorial Project Template - `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) - [论坛](https://forum.d2learn.org) |
+| [d2x Tool](https://github.com/d2learn/d2x) - [Forum](https://forum.d2learn.org) / [中文](README.zh.md) - [English](README.md) |
 | --- |
-| [文档](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) |
+| [Documentation](https://d2learn.github.io/d2x-project-template/en) -> [Tools and Environment](https://d2learn.github.io/d2x-project-template/en/chapter_1.html) -> [Project Configuration and New Content](https://d2learn.github.io/d2x-project-template/en/chapter_2.html) |
 
-该项目提供了一个, 可以被[d2x](https://github.com/d2learn/d2x)工具识别和加载的**交互式教程项目**的基础结构. 开发者和教程创作者, 可以基于这个模板来设计开发自己的交互式教程项目
+This project provides a basic structure for an **interactive tutorial project** that can be recognized and loaded by the [d2x](https://github.com/d2learn/d2x) tool. Developers and tutorial creators can design and develop their own interactive tutorial projects based on this template.
 
-## 功能特色
+## Features
 
-- 提供了基础的 `Book + Video + Code + X` 结构
-- d2x工具可以直接识别和加载
-- 提供了项目依赖描述, 支持一键配置环境
+- Provides a basic structure of `Book + Video + Code + X`
+- The d2x tool can directly recognize and load it
+- Provides project dependency description, supporting one-click environment configuration
 
-## 快速开始
+## Quick Start
 
-- 第一步: 点击 [新建教程模板](https://github.com/new?template_name=d2x-project-template&template_owner=d2learn) 按钮, 通过模板仓库创建新教程项目
-- 第二步: 克隆新仓库到本地 - `git clone git@github.com:your_name/your_repo_name.git`
-- 第三步:
-  - [安装d2x工具](https://d2learn.github.io/d2x-project-template/chapter_1.html)
-  - [认识项目结构并配置](https://d2learn.github.io/d2x-project-template/chapter_2.html)
+- Step 1: Click the [Create New Tutorial Template](https://github.com/new?template_name=d2x-project-template&template_owner=d2learn) button to create a new tutorial project from the template repository
+- Step 2: Clone the new repository to your local machine - `git clone git@github.com:your_name/your_repo_name.git`
+- Step 3:
+  - [Install d2x Tool](https://d2learn.github.io/d2x-project-template/en/chapter_1.html)
+  - [Understand Project Structure and Configuration](https://d2learn.github.io/d2x-project-template/en/chapter_2.html)
 
-## 具体项目案例
+## Project Examples
 
-| 项目 | 简介 | 备注 |
+| Project | Description | Remarks |
 | --- | --- | --- |
-| [d2mcpp](https://github.com/mcpp-community/d2mcpp) | 现代C++核心特性入门教程 | |
-| [d2ds](https://github.com/d2learn/d2ds) | 强调动手实践的数据结构学习项目 | |
+| [d2mcpp](https://github.com/mcpp-community/d2mcpp) | Tutorial on Modern C++ Core Features | |
+| [d2ds](https://github.com/d2learn/d2ds) | Data Structure Learning Project with Emphasis on Hands-on Practice | |
 
-## 其他
+## Others
 
-- [d2x工具](https://github.com/d2learn/d2x)
-- [论坛交流和反馈](https://forum.d2learn.org)
-- `交流群`: 167535744
+- [d2x Tool](https://github.com/d2learn/d2x)
+- [Forum Communication and Feedback](https://forum.d2learn.org)
+- `Chat Group`: 167535744

README.zh.md

@@ -0,0 +1,40 @@
+# d2x-project-template
+
+> 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) - [论坛](https://forum.d2learn.org) / [中文](README.zh.md) - [English](README.md) |
+| --- |
+| [文档](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工具可以直接识别和加载
+- 提供了项目依赖描述, 支持一键配置环境
+
+## 快速开始
+
+- 第一步: 点击 [新建教程模板](https://github.com/new?template_name=d2x-project-template&template_owner=d2learn) 按钮, 通过模板仓库创建新教程项目
+- 第二步: 克隆新仓库到本地 - `git clone git@github.com:your_name/your_repo_name.git`
+- 第三步:
+  - [安装d2x工具](https://d2learn.github.io/d2x-project-template/chapter_1.html)
+  - [认识项目结构并配置](https://d2learn.github.io/d2x-project-template/chapter_2.html)
+
+## 具体项目案例
+
+| 项目 | 简介 | 备注 |
+| --- | --- | --- |
+| [d2mcpp](https://github.com/mcpp-community/d2mcpp) | 现代C++核心特性入门教程 | |
+| [d2ds](https://github.com/d2learn/d2ds) | 强调动手实践的数据结构学习项目 | |
+
+## 其他
+
+- [d2x工具](https://github.com/d2learn/d2x)
+- [论坛交流和反馈](https://forum.d2learn.org)
+- `交流群`: 167535744

book/README.md

@@ -0,0 +1,5 @@
+# 书籍/文档
+
+```
+d2x book
+```

book/book.toml

@@ -1,9 +1,12 @@
 [book]
 authors = ["sunrisepeak"]
-language = "en"
+language = "zh"
 multilingual = false
 src = "src"
 title = "D2X Project Template | D2X项目模板"
 
+[build]
+build-dir = "book"
+
 [output.html]
 git-repository-url = "https://github.com/d2learn/d2x-project-template"

book/build.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+# script dir
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+
+echo "[Top] - Building Chinese book..."
+cd "$SCRIPT_DIR"
+mdbook build
+
+echo "[Sub - 1] - Building English book..."
+cd "$SCRIPT_DIR"
+cd en && mdbook build
+
+echo "[imgs] - copy imgs to output directory..."
+cd "$SCRIPT_DIR"
+cp -r imgs book/
+
+echo "Build completed."
+
+#python -m http.server --directory book

book/en/book.toml

@@ -0,0 +1,12 @@
+[book]
+authors = ["sunrisepeak"]
+language = "en"
+multilingual = false
+src = "src"
+title = "D2X Project Template | D2X项目模板"
+
+[build]
+build-dir = "../book/en"
+
+[output.html]
+git-repository-url = "https://github.com/d2learn/d2x-project-template"

book/en/src/SUMMARY.md

@@ -0,0 +1,6 @@
+# Summary
+
+- [Introduction](./chapter_0.md)
+- [Tools and Environment](./chapter_1.md)
+- [Project Configuration and New Content](./chapter_2.md)
+- [Waiting for Your Extension](./chapter_3.md)

book/en/src/chapter_0.md

@@ -0,0 +1,40 @@
+<div align=right>
+
+  🌎 [中文] | [English]
+</div>
+
+[中文]: ../chapter_0.html
+[English]: ./chapter_0.html
+
+# d2x-project-template
+
+> d2x Interactive Tutorial Project Template - `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 Tool](https://github.com/d2learn/d2x) - [Forum](https://forum.d2learn.org) |
+| --- |
+| [Documentation](https://d2learn.github.io/d2x-project-template/en) -> [Tools and Environment](https://d2learn.github.io/d2x-project-template/en/chapter_1.html) -> [Project Configuration and New Content](https://d2learn.github.io/d2x-project-template/en/chapter_2.html) |
+
+This project provides a basic structure for an **interactive tutorial project** that can be recognized and loaded by the [d2x](https://github.com/d2learn/d2x) tool. Developers and tutorial creators can design and develop their own interactive tutorial projects based on this template.
+
+## Features
+
+- Provides a basic structure of `Book + Video + Code + X`
+- The d2x tool can directly recognize and load it
+- Provides project dependency description, supporting one-click environment configuration
+
+## Project Examples
+
+| Project | Description | Remarks |
+| --- | --- | --- |
+| [d2mcpp](https://github.com/mcpp-community/d2mcpp) | Tutorial on Modern C++ Core Features | |
+| [d2ds](https://github.com/d2learn/d2ds) | Data Structure Learning Project with Emphasis on Hands-on Practice | |
+
+## Others
+
+- [d2x Tool](https://github.com/d2learn/d2x)
+- [Forum Communication and Feedback](https://forum.d2learn.org)
+- `Chat Group`: 167535744

book/en/src/chapter_1.md

@@ -0,0 +1,90 @@
+<div align=right>
+
+  🌎 [中文] | [English]
+</div>
+
+[中文]: ../chapter_1.html
+[English]: ./chapter_1.html
+
+# Tools Installation and Environment Configuration
+
+This chapter introduces how to install the d2x tool, create a template project, and perform basic environment configuration.
+
+## 1. Installing the d2x Tool
+
+### Method 1: Installation via xlings Package Manager (Recommended)
+
+[xlings](https://xlings.d2learn.org) is an open-source package manager that can solve inconsistent dependency issues across different environments.
+
+<details>
+  <summary>Click to view xlings installation command</summary>
+
+---
+
+#### Linux/MacOS
+
+```bash
+curl -fsSL https://d2learn.org/xlings-install.sh | bash
+```
+
+#### Windows - PowerShell
+
+```bash
+irm https://d2learn.org/xlings-install.ps1.txt | iex
+```
+
+> tips: xlings -> [details](https://xlings.d2learn.org)
+
+---
+
+</details>
+
+```bash
+xlings install d2x
+```
+
+### Method 2: Building from Source
+
+TODO...
+
+## 2. Creating a Project & Testing
+
+### Creating a Project
+
+**Create via Template (Recommended)**
+
+Click the [Create New Tutorial Template](https://github.com/new?template_name=d2x-project-template&template_owner=d2learn) button to create a new tutorial project from the template repository. Then, clone the generated repository to your local machine.
+
+```bash
+git clone git@github.com:your_name/your_repo_name.git
+```
+
+**Local Creation**
+
+Create a new project using the `d2x new xxx` command.
+
+```bash
+d2x new d2hello
+```
+
+After running the command, a directory named `d2hello` will be generated. Enter/open this directory to see the basic structure of the project.
+
+### Testing
+
+Enter the root directory of the newly created project and run commands to test completeness.
+
+**Documentation Preview Command Test**
+
+Running the following command will open the project's documentation/book in your browser.
+
+```bash
+d2x book
+```
+
+**Code Auto-Detection Function Test**
+
+Running the checker command below will enter the real-time code detection mode in the console. When you modify the file code, the console will update automatically.
+
+```bash
+d2x checker
+```