You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 5b836b0
Browse filesBrowse the repository at this point in the historyBrowse files
Simplify setup docs and run first-use CI from README (#92)
* docs: simplify README quick start around xlings and d2x
* docs: condense environment setup and recovery guide
* ci: exercise the documented first-use flow against the candidate commit
* ci: share the README runner with published installs and use native PowerShell
* docs: split and simplify Chinese and English environment guides
Copy file name to clipboardExpand all lines: README.md
+9-51Lines changed: 9 additions & 51 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,77 +39,35 @@
39
39
40
40
[](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=mcpp-community/d2mcpp)
41
41
42
-
Wait for environment preparation to finish (the first launch downloads a toolchain and verifies the reference answers). Then open a terminal and run `d2x checker`, or choose **Tasks: Run Task → d2mcpp: practice**. Reconnecting does not start another checker. If preparation fails, see [environment troubleshooting](docs/environment.md).
42
+
Wait for the environment to be ready, then run `d2x checker` in the terminal.
43
43
44
44
### Practice locally
45
45
46
-
Supported release targets: Linux x86_64, macOS 14+ Apple Silicon, and Windows x86_64 with Windows PowerShell 5.1+. mcpp manages the C++ toolchain; Visual Studio is optional. Linux ARM64 is not yet covered by this course's d2x release. Use your preferred editor; it is not installed as a course dependency.
46
+
**1. Install the tools**
47
47
48
-
**1. Get the course** (fork first if you want to save progress with git):
48
+
Install [xlings](docs/environment.md#install-xlings), reopen your terminal, then run:
**2. Prepare the environment.** These scripts install xlings **2026.10.18.1**, the versions in `.xlings.json` (mcpp **2026.10.17.1**, d2x **2026.08.02.2**, mdBook **0.4.43**), and build and check the Provider. The first build may take several minutes.
The PATH command makes the installed tools available in this terminal. For future sessions, reopen your terminal after installation. Preparation can be repeated and preserves your exercise files and progress.
72
-
73
-
<details>
74
-
<summary>Alternative: download with d2x install</summary>
Continue with the preparation script for your system in step 2; both download routes use the same verification below.
99
-
100
-
</details>
101
-
102
-
**3. Verify, then practice:**
61
+
**3. Verify and practice**
103
62
104
63
```bash
105
-
mcpp test -p solutions # all reference answers must pass (currently 52)
64
+
mcpp test -p solutions # all reference answers should pass
106
65
d2x checker # edit -> save -> auto-check -> advance
107
-
d2x status # progress overview
108
66
```
109
67
110
-
The unfinished exercises are expected to fail; the reference answers must pass. `Provider` errors and linker paths containing `/nonexistent/` indicate an environment problem: see [diagnosis and recovery](docs/environment.md). After `git pull`, rerun the preparation script to apply any changed pins.
68
+
The first run may take a few minutes. Errors in unfinished exercises are expected.
111
69
112
-
For native practice, `mcpp test -p src/cpp11` runs one section. See the [English usage guide](https://mcpp-community.github.io/d2mcpp/en/base/chapter_1.html).
70
+
[Setup and troubleshooting](docs/environment.md) · [Usage guide](https://mcpp-community.github.io/d2mcpp/en/base/chapter_1.html)
Copy file name to clipboardExpand all lines: README.zh.hant.md
+9-51Lines changed: 9 additions & 51 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,77 +39,35 @@
39
39
40
40
[](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=mcpp-community/d2mcpp)
41
41
42
-
等待環境準備完成（首次啟動會下載工具鏈並驗證參考答案），然後在終端執行 `d2x checker`，或使用 **Tasks: Run Task → d2mcpp: practice**。重新連線不會重複啟動 checker。準備失敗時查看[環境疑難排解](docs/environment.md)。
42
+
等待環境準備完成，然後在終端執行 `d2x checker`。
43
43
44
44
### 建立本地練習環境
45
45
46
-
支援的發行平台：Linux x86_64、macOS 14+ Apple Silicon、Windows x86_64（Windows PowerShell 5.1+）。mcpp 管理 C++ 工具鏈，Visual Studio 為選用項目。目前課程使用的 d2x Release 尚未涵蓋 Linux ARM64。可自行選擇編輯器，課程不會強制安裝。
Copy file name to clipboardExpand all lines: README.zh.md
+9-51Lines changed: 9 additions & 51 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,77 +39,35 @@
39
39
40
40
[](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=mcpp-community/d2mcpp)
41
41
42
-
等待环境准备完成（首次启动会下载工具链并验证参考答案），然后在终端运行 `d2x checker`，或使用 **Tasks: Run Task → d2mcpp: practice**。重连不会重复启动 checker。准备失败时查看[环境排错说明](docs/environment.md)。
42
+
等待环境准备完成，然后在终端运行 `d2x checker`。
43
43
44
44
### 搭建本地练习环境
45
45
46
-
支持的发布平台：Linux x86_64、macOS 14+ Apple Silicon、Windows x86_64（Windows PowerShell 5.1+）。mcpp 管理 C++ 工具链，Visual Studio 为可选项。当前课程所用 d2x Release 尚未覆盖 Linux ARM64。编辑器可自行选择，课程不会强制安装。
0 commit comments