Skip to content

Commit b6ef0f6

Browse files
feat(i18n): 补全并修复 EN 翻译,修 translate.py 两处静默丢内容 bug
全量补译 447 篇 CN→EN (glm-4.6),本次更新 337 篇 + 新增 1 篇。 translate.py 两处根因修复: 1. 8192 输出截断: MAX_SINGLE_FILE_CHARS 60K→14K,长文件按 ## 拆块,避免单块英译撞 max_tokens 上限被静默截断(曾致 ReferenceCard 未闭合炸构建)。 2. glm-4.6 剥占位符: 改 prose-only 流水线(_translate_body_prose_only),按代码块边界切、代码逐字保留、\n\n 缝合,替代对 glm-4.6 失效的 __PRESERVED_N__ 机制。 附带: coverage.py --update 补全 EN translation 元数据块、刷新 README 覆盖率徽章; v0.6.0 changelog。 验证: 447 篇 EN 结构差异归零,markdownlint 通过,构建 ✓ SUCCESS。
1 parent 35b5fbc commit b6ef0f6

341 files changed

Lines changed: 41485 additions & 52538 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

README.en.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
![Tag](https://img.shields.io/github/v/tag/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP?sort=semver&label=tag)
1717
![License](https://img.shields.io/github/license/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
1818
![Build](https://img.shields.io/github/actions/workflow/status/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP/deploy.yml?branch=main)
19+
![AI agent ready](https://img.shields.io/badge/AI%20agent-ready-7C3AED)
1920

2021
---
2122

@@ -161,6 +162,16 @@ See [changelogs/](changelogs/) for full release history.
161162

162163
</details>
163164

165+
## Use an AI agent (optional)
166+
167+
This repo is ready for AI coding agents out of the box, and you're welcome to use an agent for learning or contributing:
168+
169+
- 🤖 [AGENTS.md](./AGENTS.md) — vendor-neutral entry point (works with Claude Code / Cursor / Copilot / Codex / …)
170+
- 📚 [Learn C++ with an agent](./.github/learning-with-agents.md) + [common C++ misconceptions FAQ](./.github/faq.md)
171+
- ✍️ Claude-specific assets (writing style / review commands / hooks): see [CLAUDE.md](./CLAUDE.md)
172+
173+
> Not using an agent? Just ignore these files — the main tutorials and examples don't depend on them.
174+
164175
## Contributing
165176

166177
Contributions are welcome: documentation fixes, example improvements, new chapters, translation review, issue reports, content suggestions, or submissions to [Community Articles](https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/en/community/). Please read [CONTRIBUTING.md](./CONTRIBUTING.md) first.

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,12 @@
1515
![Tag](https://img.shields.io/github/v/tag/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP?sort=semver&label=tag)
1616
![License](https://img.shields.io/github/license/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
1717
![Build](https://img.shields.io/github/actions/workflow/status/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP/deploy.yml?branch=main)
18+
![AI agent ready](https://img.shields.io/badge/AI%20agent-ready-7C3AED)
1819

1920
---
2021

2122
<!-- COVERAGE_START -->
22-
![English Coverage](https://img.shields.io/badge/en_coverage-100%25-green.svg) 439/440 docs translated
23+
![English Coverage](https://img.shields.io/badge/en_coverage-100%25-green.svg) 440/440 docs translated
2324
<!-- COVERAGE_END -->
2425

2526
## 这是什么项目
@@ -164,6 +165,16 @@ cmake -S code/examples/chapter05/06_array_vs_stdarray -B build && cmake --build
164165

165166
</details>
166167

168+
## 用 AI Agent 辅助(可选)
169+
170+
本项目对 AI coding agent 开箱即用,也欢迎用 agent 辅助学习与贡献:
171+
172+
- 🤖 [AGENTS.md](./AGENTS.md) —— 跨 agent 通用入口(Claude Code / Cursor / Copilot / Codex 等都读它)
173+
- 📚 [用 agent 辅助 C++ 学习](./.github/learning-with-agents.md) + [C++ 常见误解 FAQ](./.github/faq.md)
174+
- ✍️ Claude 专属资产(写作风格 / 审查命令 / hooks)见 [CLAUDE.md](./CLAUDE.md)
175+
176+
> 不用 agent?忽略这些文件即可,主线教程与示例不依赖它们。
177+
167178
## 贡献
168179

169180
欢迎修正文档、改进示例、补充章节、校对翻译、提交问题、提出内容建议,或向 [社区文章](https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/community/) 投稿。请先阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)

changelogs/v0.6.0.md

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
# v0.6.0 (2026-06-16)
2+
3+
内容主线里程碑:卷三「标准库」容器篇完工、迭代器篇起步,卷八「嵌入式」做了一次系统性的内容刷新与归属重组,卷十新增两个 CppCon 2025 笔记系列;平台层完成了站点视觉重做与 Agent 协作接入,并把学习路线图中英双语重写。
4+
5+
## 卷三:标准库重建推进
6+
7+
按 v0.5.0 路线图「012 卷三全面重建」继续推进,本轮新增 15 篇正文,覆盖第一部分(容器)完工与第二部分(迭代器)起步:
8+
9+
**第一部分「容器与内存」完工(14 篇,均含可运行代码,核心章节附真实终端实测)**
10+
11+
- **选型与基础** — 容器选择指南(按操作/内存/失效规则挑容器)、`std::array``std::initializer_list`、对象大小/对齐/平凡类型
12+
- **顺序容器深入**`vector`(三指针/扩容/迭代器失效)、`string`(SSO/COW/`resize_and_overwrite`)、`deque`/`list`/`forward_list`
13+
- **关联容器**`map`/`set`(红黑树/异构查找/节点句柄)、`unordered_map`/`unordered_set`(哈希表/桶/自定义 hash)
14+
- **视图与适配器**`std::span`、容器适配器(stack/queue/priority_queue 的包装机制)
15+
- **新标准容器**`flat_map``inplace_vector``mdspan`(按 C++23/26 编译器支持度标注)
16+
- **内存** — 自定义分配器与 PMR
17+
- **字符与编码**`char8_t` 与 UTF-8 字符串
18+
19+
**第二部分「迭代器/算法」起步(1 篇)**
20+
21+
- 迭代器基础与 category:容器和算法靠什么对接
22+
23+
同时执行了 v0.5.0 规划的**归属迁移**:把 `type-safe register``circular buffer``intrusive containers` 三篇非标准库内容迁出至卷八,让卷三回归「标准库」本位。卷三第二部分余下文章(STL 算法、ranges 进阶等)与第三部分(通用设施/libc++ 源码阅读)仍待后续推进。
24+
25+
## 卷八:嵌入式内容刷新与重组
26+
27+
嵌入式卷在 v0.5.0 已有完整骨架(环境搭建、LED、Button、UART 整条 hands-on 链),本轮做的是系统性**内容刷新 + 归属重组**,而非从零起步:
28+
29+
- 对环境搭建、LED、Button、UART 等章节做了内容修订与统一
30+
- 接收卷三迁入的 type-safe register / circular buffer / intrusive containers 三篇
31+
- 把 Empty Base Optimization 迁出至卷四(归属更贴「高级主题」)
32+
- 新增各章节 landing 索引页,删除已过时的 `array-vs-raw-arrays`
33+
34+
## 卷十:CppCon 2025 笔记扩展
35+
36+
新增两个 Back to Basics 系列(各 3 篇正文 + 导读):
37+
38+
- **Back to Basics: Ranges** — 从循环到迭代器、STL 算法与迭代器陷阱、ranges views 与组合
39+
- **Back to Basics: Move Semantics** — 拷贝代价与动机、值类别与引用、移动操作/`std::move`/拷贝消除
40+
41+
## 卷四:高级
42+
43+
从卷八迁入 Empty Base Optimization 一文(归属调整)。
44+
45+
## Agent 协作接入
46+
47+
让仓库对 AI 编程助手(Claude Code 等)开箱即用,建立跨 agent 的统一入口与协作约定:
48+
49+
- 新增 **AGENTS.md** 跨 agent 入口与 **CLAUDE.md**,沉淀项目级指令
50+
- 开放 `.claude/` 协作设施:`patch` / `minor` / `new-article` / `audit` / `preflight` / `verify-claim` / `explain` 等命令、写作风格与文档 frontmatter 规则、文章事实核查与严谨度审查 prompt、bare-python 拦截钩子
51+
- 新增 `.github/faq.md``.github/learning-with-agents.md`,面向读者与贡献者说明如何借助 agent 学习与协作
52+
53+
## 站点视觉重做
54+
55+
首页与内容呈现层做了一次成体系的视觉刷新:
56+
57+
- 新增 `HomeHeroVisual``HomeRoadmap` 首页可视化组件
58+
- 新增 `ProofStrip`(实验证据条)、`ScreenshotCarousel`(截图轮播)组件
59+
- 重做 `OnlineCompilerDemo` 在线编译演示
60+
- 引入 shiki 语法高亮、新增 build-info 注入
61+
- 配套移动端阅读修复与整体样式调整
62+
63+
## 学习路线图重写
64+
65+
中英双语重写 `documents/roadmap/index.md`,按稳定信号(主题/难度/前置/平台/成熟度)组织,不堆砌篇数与统计。
66+
67+
## 社区与协作
68+
69+
新增社区/dev 迭代节奏文档与社区入口页,沉淀 patch/minor 迭代约定。
70+
71+
## 内容修复
72+
73+
- filesystem 代码示例细节修正(#45@YukunJ
74+
- 修复 filesystem 原子操作章节的错误注释(#46@YukunJ
75+
76+
## 翻译
77+
78+
- 同步本版本全部中文内容变更至英文,并对多个卷的英文文档做了批量同步校对
79+
80+
## 贡献者
81+
82+
Charliechen114514、YukunJ
83+
84+
## 内容数据
85+
86+
| 指标 | 数量 |
87+
|------|------|
88+
| 文件变更 | 834 files(+30,566 / -19,870) |
89+
| 提交数 | 15 |
90+
| 合并 PR | #45#64(共 12 个) |
91+
| 贡献者 | Charliechen114514、YukunJ |

documents/en/404.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,11 @@ tags:
88
- host
99
title: Page Not Found
1010
translation:
11-
engine: anthropic
1211
source: documents/404.md
13-
source_hash: 5e0383392a35876a04fd1237a4ab9b52d22c34468522ffe9ee5a8998b76926bc
14-
token_count: 60
15-
translated_at: '2026-05-26T10:08:15.033103+00:00'
12+
source_hash: 23dee62665f54f41a7b8c572196eb6684a0183c2f2c75b625dd0e8d1b91f628d
13+
translated_at: '2026-06-16T03:26:05.272732+00:00'
14+
engine: anthropic
15+
token_count: 64
1616
---
1717
# 404
1818

0 commit comments

Comments
 (0)