update readme & useage guide

Author: Sunrisepeak

.vscode/settings.json

@@ -15,5 +15,8 @@
     },
 
     "files.autoSave": "afterDelay", // or "onFocusChange", "onWindowChange", "off"
-    "files.autoSaveDelay": 1000 // Only relevant for "afterDelay", in milliseconds
+    "files.autoSaveDelay": 1000,
+    "files.associations": {
+        "ostream": "cpp"
+    } // Only relevant for "afterDelay", in milliseconds
 }

README.md

@@ -28,6 +28,9 @@
 - **`[Familiarize]`** - The ability to solve unfamiliar C++ problems using documentation and [cppreference](https://cppreference.com)
 - **`[Understand]`** - How to participate in the technical community — using open-source projects, asking questions, joining discussions, or contributing
 
+> [!CAUTION]
+> This project is currently in its early development stage. If you encounter any issues, feel free to create an issue for feedback or directly submit a PR to fix it.
+
 ## Quick Start
 
 > Try `Code -> Book -> Video -> X -> Code`

README.zh.hant.md

@@ -28,6 +28,9 @@
 - **`[熟悉]`** - 透過文件和[cppreference](https://cppreference.com)解決C++中不熟悉問題的能力
 - **`[了解]`** - 如何參與技術社群 - 開源專案的使用、提出問題、參與討論或貢獻
 
+> [!CAUTION]
+> 該項目當前處於開發初期, 如果你發現任何問題, 歡迎創建issues反饋或直接提交PR進行修復
+
 ## 快速開始
 
 > 嘗試 `Code -> Book -> Video -> X -> Code`

README.zh.md

@@ -21,6 +21,9 @@
 [⌨️Code]: https://github.com/Sunrisepeak/mcpp-standard/tree/main/dslings
 [👥X]: https://forum.d2learn.org/category/20
 
+> [!CAUTION]
+> 该项目当前处于开发初期, 如果你发现任何问题, 欢迎创建issues反馈或直接提交PR进行修复
+
 ## 目标
 
 - **`[掌握]`** - **现代C++核心的语言特性**及使用场景

book/en/src/base/chapter_1.md

@@ -53,13 +53,13 @@ d2x book
 > Enter the project directory `mcpp-standard` and run the checker command to enter the practice code auto-detection program
 
 ```bash
-xlings checker
+d2x checker
 ```
 
 ### Specify Exercise for Detection
 
 ```bash
-xlings checker [name]
+d2x checker [name]
 ```
 
 > Note: Exercise names support fuzzy matching
@@ -149,7 +149,23 @@ dslings/hello-mcpp.cpp -->> Current detected file
 Homepage: https://github.com/d2learn/xlings
 ```
 
-## 3. Resources and Communication
+## 3. Configure Project Language
+
+Edit the `lang` attribute in the project configuration file `config.xlings`. `zh` corresponds to Chinese, and `en` corresponds to English.
+
+```lua
+    },
+
+    private = {
+        -- project private attributes
+        mcpp = {
+            lang = "en", -- option: en, zh
+        }
+    },
+}
+```
+
+## 4. Resources and Communication
 
 **Communication Group (Q):** 167535744
 

book/src/base/chapter_1.md

@@ -8,7 +8,7 @@
 
 # 使用说明
 
-**mcpp-standard**是一个强调动手实践的现代C++核心语言特性教程项目。基于[xlings(d2x)工具](https://github.com/Sunrisepeak/mcpp-standard)搭建了一套**编译器驱动开发模式**的代码练习, 可以自动化的检测练习代码的状态和跳转到下一个练习...
+**mcpp-standard**是一个强调动手实践的现代C++核心语言特性教程项目。基于[xlings(d2x)工具](https://github.com/d2learn/xlings)搭建了一套**编译器驱动开发模式**的代码练习, 可以自动化的检测练习代码的状态和跳转到下一个练习...
 
 ## 0.xlings工具安装
 
@@ -53,13 +53,13 @@ d2x book
 > 进入项目目录`mcpp-standard`运行checker命令, 进入练习代码自动检测程序
 
 ```bash
-xlings checker
+d2x checker
 ```
 
 ### 指定练习进行检测
 
 ```bash
-xlings checker [name]
+d2x checker [name]
 ```
 
 > 注: 练习名支持模糊匹配
@@ -74,7 +74,7 @@ d2x update
 
 ## 2.自动化检测程序简介
 
-使用`xlings checker`进入自动化代码练习环境后, 工具会自动定位打开对应的练习代码文件, 并在控制台输出提示编译器的错误及提示信息。一般检测程序分两个检测阶段: 第一个是编译期检测, 即你需要通过练习代码中的提示信息和控制台编译器的报错, 修复代码的编译错误; 第二个是运行时检测, 即当前代码运行时是否能通过所有检查点。当修复编译错误并通过所有检查点时, 控制台就会显示当前练习通过并提示你进入下一个练习
+使用`d2x checker`进入自动化代码练习环境后, 工具会自动定位打开对应的练习代码文件, 并在控制台输出提示编译器的错误及提示信息。一般检测程序分两个检测阶段: 第一个是编译期检测, 即你需要通过练习代码中的提示信息和控制台编译器的报错, 修复代码的编译错误; 第二个是运行时检测, 即当前代码运行时是否能通过所有检查点。当修复编译错误并通过所有检查点时, 控制台就会显示当前练习通过并提示你进入下一个练习
 
 **代码练习文件示例**
 
@@ -147,7 +147,23 @@ dslings/hello-mcpp.cpp -->> 当前检测的文件
 Homepage: https://github.com/d2learn/xlings
 ```
 
-## 3.资源于交流
+## 3.配置项目语言
+
+编辑项目配置文件`config.xlings`中的`lang`属性, `zh`对应中文, `en`对应英文
+
+```lua
+    },
+
+    private = {
+        -- project private attributes
+        mcpp = {
+            lang = "en", -- option: en, zh
+        }
+    },
+}
+```
+
+## 4.资源于交流
 
 **交流群(Q):** 167535744