Skip to content

Commit 6997be4

Browse files
committed
update readme & add support for en/zh.hant
1 parent fc1d333 commit 6997be4

File tree

11 files changed

+248
-152
lines changed

11 files changed

+248
-152
lines changed

README.md

Lines changed: 42 additions & 150 deletions
Original file line numberDiff line numberDiff line change
@@ -1,106 +1,45 @@
1-
<div align=center><img width="640" src="https://github.com/user-attachments/assets/bc0f1007-752e-4da5-844b-dab246198e85"></div>
1+
<div align=right>
22

3-
<div align="center">
4-
<a href="https://forum.d2learn.org/category/20" target="_blank"><img src="https://img.shields.io/badge/D2Learn-mcpp_standard-blue" /></a>
5-
<a href="https://d2learn.org" target="_blank"><img src="https://img.shields.io/badge/License-Apache2.0-success" alt="License"></a>
6-
<a href="https://space.bilibili.com/65858958/lists/5208246" target="_blank"><img src="https://img.shields.io/badge/Video-bilibili-teal" alt="Bilibili"></a>
3+
[中文] | [繁體中文] | [English] | [Todo]
74
</div>
85

9-
<div align="center">
10-
<a href="https://sunrisepeak.github.io/mcpp-standard" target="_blank">在线电子书</a>
11-
|
12-
<a href="https://www.bilibili.com/video/BV182MtzPEiX" target="_blank">介绍</a>
13-
|
14-
<a href="videos" target="_blank">视频/动画</a>
15-
|
16-
<a href="https://forum.d2learn.org/category/20" target="_blank">论坛</a>
17-
|
18-
<a href="https://github.com/d2learn/xlings" target="_blank">工具</a>
19-
</div>
20-
21-
<div align=center><b>动手学现代C++核心语言特性</b> | 交互式的代码练习</div>
22-
23-
---
24-
25-
## 活动 | [ 📣 MSCP - mcpp项目学习与贡献者培养计划 ](https://moga.d2learn.org/activity/mscp/intro.html)
26-
27-
> MSCP是一款基于mcpp-standard开源项目开发的"地球Online"风格的角色扮演游戏。在游戏中你将扮演一个"编程初学者", 为了入门"现代C++"并揭露其背后的真相, 踏上了一条充满挑战和惊奇的现代C++学习之路...
28-
29-
- `价格:` 免费
30-
- `开发者:` [Sunrisepeak](https://github.com/Sunrisepeak)
31-
- `发行商:` [MOGA](https://moga.d2learn.org)
32-
- `发行时间:` 2025年10月
33-
- `游戏体量:` 100H - 200H之间
34-
- `标签:` 类魂系列、模拟人生、🌍Online、程序员、C++、开源、费曼学习法
35-
- [-> 游戏详情](https://moga.d2learn.org/activity/mscp/intro.html)
36-
37-
## 更新日志 - [ 2025/09/15 ]
38-
39-
> 持续更新中
40-
41-
**C++11 - 11 - 继承造函数**
42-
43-
- **[code-0](https://github.com/Sunrisepeak/mcpp-standard/blob/main/dslings/cpp11/11-inherited-constructors-0.cpp) / [code-1](https://github.com/Sunrisepeak/mcpp-standard/blob/main/dslings/cpp11/11-inherited-constructors-1.cpp) / [code-2](https://github.com/Sunrisepeak/mcpp-standard/blob/main/dslings/cpp11/11-inherited-constructors-2.cpp)** - 2025/08/29
44-
- **[book](https://sunrisepeak.github.io/mcpp-standard/cpp11/11-inherited-constructors.html)** - 2025/08/28
45-
- **video:** [Bili](https://www.bilibili.com/video/BV1bspBzFEEC) / [Youtube](https://youtu.be/p7vbY8XUKnY?si=GZUn9GSW68aU94A6) / [Code](https://github.com/Sunrisepeak/mcpp-standard/blob/main/videos/cpp11/11-inherited-constructors.py) - 2025/09/15
6+
<div align=center>
7+
<img width="320" src="https://github.com/user-attachments/assets/dcc6bdea-71f8-4ed5-b445-6449c88655f3">
468

47-
**获取最新内容**
9+
<em>Dive to | Modern C++ Core Language Features - <b>"A C++ tutorial project focused on practical"</b></em>
4810

49-
```bash
50-
d2x update
51-
```
52-
53-
更多 -> [changelog](https://github.com/Sunrisepeak/mcpp-standard/blob/main/book/src/changelog.md)
54-
55-
---
56-
57-
## 目标
58-
59-
**项目视角**
60-
61-
- **1.** 任何人都可以在网上**免费获取**课程资源
62-
- **2.** 强调通过**动手实践/代码练习**的方式来学习
63-
- **3.** 提供**自动化的代码练习 + 方便的环境搭建**的工具支持
64-
- **4.** 通过社区共享、共建、互助实现良性循环 - **开源 + 论坛**
65-
66-
**使用者视角**
11+
<b> [Book] + [Video] + [Code] + [X] </b>
12+
</div>
6713

68-
- [掌握] - **现代C++核心的语言特性**及使用场景
69-
- [掌握] - 通过编译器报错信息**定位问题的能力**
70-
- [熟悉] - 通过文档和cppreference解决C++中不熟悉问题的能力
71-
- [了解] - 如何参与技术社区 - 开源项目的使用、提问题、参与讨论或贡献的姿势
14+
[中文]: README.zh.md
15+
[繁體中文]: README.zh.hant.md
16+
[English]: README.md
17+
[Todo]: README.md
7218

73-
## 交互式代码练习
19+
[Book]: https://sunrisepeak.github.io/mcpp-standard
20+
[Video]: https://www.bilibili.com/video/BV182MtzPEiX
21+
[Code]: https://github.com/Sunrisepeak/mcpp-standard/tree/main/dslings
22+
[X]: https://forum.d2learn.org/category/20
7423

75-
- 🌍练习进度/状态显示
76-
- 📍自动定位练习代码文件
77-
- ✅实时的代码检查和结果验证
78-
- 🤖~AI智能**代码引导**~
24+
## Goals
7925

80-
<div align=center><img width="840" src="book/imgs/mcpp-standard-demo.gif"></div>
26+
- [Master] - **Core language features of Modern C++** and their usage scenarios
27+
- [Master] - The ability to **identify and debug issues** using compiler error messages
28+
- [Familiarize] - The ability to solve unfamiliar C++ problems using documentation and [cppreference](https://cppreference.com)
29+
- [Understand] - How to participate in the technical community — using open-source projects, asking questions, joining discussions, or contributing
8130

82-
## 快速开始
31+
## Quick Start
8332

84-
### 在线体验
33+
### Online Code Practice
8534

86-
> [**点击下面按钮**](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=Sunrisepeak/mcpp-standard) 即可在云端自动完成配置, 并进入练习代码检测模式
35+
> [**click the button below**](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=Sunrisepeak/mcpp-standard) to automatically complete the configuration in the cloud and enter the practice code detection mode
8736
8837
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=Sunrisepeak/mcpp-standard)
8938

90-
> **提示:**
91-
>
92-
> * 更多项目使用细节, 可以参考 **本地练习环境快速搭建**[项目在线文档](https://sunrisepeak.github.io/mcpp-standard)
93-
> * 使用完毕请记得在 Codespaces 界面 Stop 容器,以节省额度。
94-
95-
96-
### 本地练习环境快速搭建
97-
98-
> 通过使用[xlings](https://github.com/d2learn/xlings)获取项目并运行**编译器驱动开发模式**(自动化检测)来进行代码练习
99-
>
100-
> - 环境搭建演示视频: [windows](https://www.bilibili.com/video/BV1L4KuzEEcE) - [linux](https://www.bilibili.com/video/BV182MtzPEiX?p=2) - [macos](https://www.bilibili.com/video/BV182MtzPEiX?p=2)
39+
### Local Practice Environment
10140

10241
<details>
103-
<summary>点击查看xlings安装命令</summary>
42+
<summary>click to view xlings installation command</summary>
10443

10544
---
10645

@@ -116,89 +55,42 @@ curl -fsSL https://d2learn.org/xlings-install.sh | bash
11655
irm https://d2learn.org/xlings-install.ps1.txt | iex
11756
```
11857

119-
> 注: xlings包含所需的xim和d2x工具 -> [详情](https://d2learn.org/xlings)
58+
> tips: xlings -> [details](https://xlings.d2learn.org)
12059
12160
---
12261

12362
</details>
12463

125-
#### 获取项目
126-
127-
> 下载项目到当前目录并自动配置本地环境
128-
12964
```bash
13065
xlings install d2x:mcpp-standard
66+
cd mcpp-standard
67+
d2x checker
13168
```
13269

133-
#### 本地文档/电子书(可选)
134-
135-
> 可以在项目目录执行`d2x book`命令, 打开本地文档(包含使用说明和电子书)
136-
137-
```bash
138-
d2x book
139-
```
140-
141-
#### 练习代码自动检测
142-
143-
> 在项目目录`mcpp-standard`运行checker命令, 进入练习代码自动检测程序
144-
145-
```bash
146-
xlings checker
147-
```
148-
149-
#### 同步最新的练习代码
150-
151-
> 由于项目处于持续更新阶段, 可以使用下面的命令进行自动同步(如果同步失败, 可能需要手动用git进行更新项目代码)
152-
153-
```bash
154-
d2x update
155-
```
156-
157-
---
158-
159-
## 练习及视频解读列表
160-
161-
| c++标准 | 特性 | 标题 | 文档/练习代码/视频 | 备注 |
162-
| --- | --- | --- | --- | --- |
163-
| **引导** | `项目使用教程/引导` | hello mcpp | [docs](https://github.com/Sunrisepeak/mcpp-standard/blob/main/book/src/chapter_1.md) / [code](/dslings/hello-mcpp.cpp) / [video](https://www.bilibili.com/video/BV182MtzPEiX?p=2) | |
164-
| **cpp11** | `00 - auto和decltype` | 类型自动推导 | [docs](https://github.com/Sunrisepeak/mcpp-standard/blob/main/book/src/cpp11/00-auto-and-decltype.md) / [code](/dslings/cpp11/00-auto-and-decltype-0.cpp) / [video](https://www.bilibili.com/video/BV1xkdYYUEyH) | |
165-
| | | decltype注意事项 | [code](/dslings/cpp11/00-auto-and-decltype-4.cpp) / [video](https://www.bilibili.com/video/BV1KWoMYUEzW) | [补充](https://forum.d2learn.org/topic/82) |
166-
| | `01 - default和delete` | 控制默认构造函数生成 | [code](/dslings/cpp11/01-default-and-delete-0.cpp) / [video](https://www.bilibili.com/video/BV1B35pz5EN2) | |
167-
| | | 类型对象行为控制示例 | [code](/dslings/cpp11/01-default-and-delete-1.cpp) / [video](https://www.bilibili.com/video/BV1Vg5tznE8o) | |
168-
| | `02 - override和final` | 重写显示意图和编译器检查 | [code](/dslings/cpp11/02-final-and-override-0.cpp) / [video](https://www.bilibili.com/video/BV1BdLJz6EKJ) | |
169-
| | | 继承和重现限制 | [code](/dslings/cpp11/02-final-and-override-1.cpp) / [video](https://www.bilibili.com/video/BV1H1jAzTEYT) | |
170-
| | `03 - 后置返回值类型` | 后置返回值类型基础用法 | [code](/dslings/cpp11/03-trailing-return-type.cpp) / [video](https://www.bilibili.com/video/BV1Ma5wzgE9h) | |
171-
| | `04 - 右值引用` | 临时对象生命周期延长的可变性质 | [code](/dslings/cpp11/04-rvalue-references.cpp) / [video](https://www.bilibili.com/video/BV1vn5wzmEVk) | |
172-
| | `05 - 移动语义` | 移动构造和触发时机 | [code](/dslings/cpp11/05-move-semantics-0.cpp) / [video](https://www.bilibili.com/video/BV19gj9zAERL) | |
173-
| | | 移动赋值和触发时机 | [code](/dslings/cpp11/05-move-semantics-1.cpp) / [video](https://www.bilibili.com/video/BV1NDjRzREsY) | |
174-
| | | 移动的不是对象而是资源 | [code](/dslings/cpp11/05-move-semantics-2.cpp) / [video](https://www.bilibili.com/video/BV1P9jRzXE3a) | |
175-
| | `06 - 作用域枚举` | 传统枚举的问题 | [code](/dslings/cpp11/06-scoped-enums-0.cpp) / [video](https://www.bilibili.com/video/BV1fn7iz4EuR) | |
176-
| | | 作用域枚举的基本用法 | [code](/dslings/cpp11/06-scoped-enums-1.cpp) / [video](https://www.bilibili.com/video/BV1fn7iz4EuR) | |
177-
| | `07 - constexpr` | const和constexpr有什么不同 | [code](/dslings/cpp11/07-constexpr-0.cpp) / [video](https://www.bilibili.com/video/BV1LRMLzgE4w) | |
178-
| | | 编译期计算应用示例 | [code](/dslings/cpp11/07-constexpr-1.cpp) / [video](https://www.bilibili.com/video/BV15CMEzLEuN) | |
179-
| | [...](/videos) | [...](/videos) | [...](/videos) | |
70+
**👉 [more details...](https://sunrisepeak.github.io/mcpp-standard/base/chapter_1.html)**
18071

181-
## 社区 | 交流
72+
## Community
18273

183-
- **即时交流(QQ群):** 167535744、1067245099
184-
- [**论坛版块:**](https://forum.d2learn.org/category/20): 项目相关的练习代码、技术交流和讨论
74+
- **groups:** [mcpp forum](https://forum.d2learn.org/category/20)
75+
- [**forum:**](https://forum.d2learn.org/category/20) issues feedback, practice code, technical discussions
76+
- **community activities:** [📣 MSCP - mcpp project learning and contributor training program](https://moga.d2learn.org/activity/mscp/intro.html)
18577

186-
> **:** 复杂性问题(技术、环境搭建等问题)推荐在论坛发帖, 并详细描述问题细节, 能更有效于问题的解决和复用
78+
> **Note:** Complex issues (technical, environment setup, etc.) are recommended to be posted on the forum and detailed description of the problem can be more effective in problem solving and reuse.
18779
188-
## 参与项目 | 社区贡献
80+
## Contributing
18981

190-
- **参与社区交流:** 反馈问题、参与社区问题讨论
191-
- **参与项目维护和开发:** 参与社区中问题处理、修复Bug、开发&优化新功能/模块
82+
- **Community Communication:** Report issues, participate in community discussions, and help new users solve problems.
83+
- **Project Maintenance and Development:** Participate in community issue resolution, bug fixes, multilingual support, [join the MSCP activity group](https://moga.d2learn.org/activity/mscp/docs/join-group.html), and develop and optimize new features and modules.
19284

193-
**📑开源协议与贡献许可(License & CLA)**
85+
**📑License & CLA**
19486

195-
- 本项目欢迎自由使用与分发!你可以在 [Apache License 2.0](LICENSE-CODE) [CC-BY-NC-SA 4.0](LICENSE-BOOK) 协议下**免费**使用、修改和分享本项目的代码与文档内容
196-
- 如希望参与贡献代码或文档,请先阅读[贡献者许可协议(CLA](CLA.md)
87+
- This project welcomes free use and distribution! You may use, modify, and share the code and documentation in this project **free** under the [Apache License 2.0](LICENSE-CODE) and [CC-BY-NC-SA 4.0](LICENSE-BOOK) licenses.
88+
- If you would like to contribute code or documentation, please read the [Contributor License Agreement (CLA)](CLA.md) first.
19789

198-
**👥贡献者**
90+
**👥Contributors**
19991

20092
<a href="https://github.com/Sunrisepeak/mcpp-standard/graphs/contributors">
20193
<img src="https://contrib.rocks/image?repo=Sunrisepeak/mcpp-standard" />
20294
</a>
20395

204-
<a href="https://hellogithub.com/repository/Sunrisepeak/mcpp-standard" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=7877f7cb12e940a5a432d49c19a360df&claim_uid=aNLTSv91Awj8ruX&theme=dark" alt="Featured|HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
96+
<a href="https://hellogithub.com/repository/Sunrisepeak/mcpp-standard" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=7877f7cb12e940a5a432d49c19a360df&claim_uid=aNLTSv91Awj8ruX&theme=dark" alt="Featured|HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>

README.zh.hant.md

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
<div align=right>
2+
3+
[中文] | [繁體中文] | [English] | [Todo]
4+
</div>
5+
6+
<div align=center>
7+
<img width="320" src="https://github.com/user-attachments/assets/dcc6bdea-71f8-4ed5-b445-6449c88655f3">
8+
9+
<em>動手做 | 現代CPP核心語言特性 - <b>"強調動手實作的C++教學專案"</b></em>
10+
11+
<b> [Book] + [Video] + [Code] + [X] </b>
12+
</div>
13+
14+
[中文]: README.zh.md
15+
[繁體中文]: README.zh.hant.md
16+
[English]: README.md
17+
[Todo]: README.md
18+
19+
[Book]: https://sunrisepeak.github.io/mcpp-standard
20+
[Video]: https://www.bilibili.com/video/BV182MtzPEiX
21+
[Code]: https://github.com/Sunrisepeak/mcpp-standard/tree/main/dslings
22+
[X]: https://forum.d2learn.org/category/20
23+
24+
## 目標
25+
26+
- [掌握] - **現代C++核心的語言特性**及使用場景
27+
- [掌握] - 透過編譯器報錯資訊**定位問題的能力**
28+
- [熟悉] - 透過文件和[cppreference](https://cppreference.com)解決C++中不熟悉問題的能力
29+
- [了解] - 如何參與技術社群 - 開源專案的使用、提出問題、參與討論或貢獻
30+
31+
## 快速開始
32+
33+
### 線上程式碼練習
34+
35+
> [**點擊下方按鈕**](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=Sunrisepeak/mcpp-standard) 即可在雲端自動完成設定, 並進入練習程式碼偵測模式
36+
37+
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=Sunrisepeak/mcpp-standard)
38+
39+
### 建立本地練習環境
40+
41+
<details>
42+
<summary>點選查看xlings安裝指令</summary>
43+
44+
---
45+
46+
#### Linux/MacOS
47+
48+
```bash
49+
curl -fsSL https://d2learn.org/xlings-install.sh | bash
50+
```
51+
52+
#### Windows - PowerShell
53+
54+
```bash
55+
irm https://d2learn.org/xlings-install.ps1.txt | iex
56+
```
57+
58+
> 註: xlings工具 -> [詳情](https://xlings.d2learn.org)
59+
60+
---
61+
62+
</details>
63+
64+
```bash
65+
xlings install d2x:mcpp-standard
66+
cd mcpp-standard
67+
d2x checker
68+
```
69+
70+
**👉 [更多細節...](https://sunrisepeak.github.io/mcpp-standard/base/chapter_1.html)**
71+
72+
## 社區
73+
74+
- **即時交流:** 167535744、1067245099
75+
- [**論壇版塊:**](https://forum.d2learn.org/category/20) 問題回饋、練習程式碼、技術交流與討論
76+
- **社區活動:** [📣 MSCP - mcpp計畫學習與貢獻者培養計畫](https://moga.d2learn.org/activity/mscp/intro.html)
77+
78+
> **註:** 複雜性問題(技術、環境搭建等問題)推薦在論壇發文, 並詳細描述問題細節, 能更有效於問題的解決與復用
79+
80+
## 參與貢獻
81+
82+
- **參與社群交流:** 回饋問題、參與社群問題討論、幫助社群新用戶解決問題
83+
- **參與專案維護與開發:** 參與社區中問題處理、修復Bug、多語言支援、[加入MSCP活動小組](https://moga.d2learn.org/activity/mscp/docs/join-group.html)、開發&最佳化新功能/模組
84+
85+
**📑開源協議與貢獻許可(License & CLA)**
86+
87+
- 本項目歡迎自由使用與分發!你可以在 [Apache License 2.0](LICENSE-CODE)[CC-BY-NC-SA 4.0](LICENSE-BOOK) 協議下**免費**使用、修改和分享本專案的程式碼與文件內容
88+
- 如希望參與貢獻程式碼或文檔,請先閱讀[貢獻者授權協議(CLA)](CLA.md)
89+
90+
**👥貢獻者**
91+
92+
<a href="https://github.com/Sunrisepeak/mcpp-standard/graphs/contributors">
93+
<img src="https://contrib.rocks/image?repo=Sunrisepeak/mcpp-standard" />
94+
</a>
95+
96+
<a href="https://hellogithub.com/repository/Sunrisepeak/mcpp-standard" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=7877f7cb12e940a5a432d49c19a360df&claim_uid=aNLTSv91Awj8ruX&theme=dark" alt="Featured|HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>

0 commit comments

Comments
 (0)