Skip to content

feat(i18n): 补全并修复 EN 翻译，修 translate.py 两处静默丢内容 bug #65

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Charliechen114514 merged 2 commits into from
Jun 16, 2026
Merged

feat(i18n): 补全并修复 EN 翻译，修 translate.py 两处静默丢内容 bug #65

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b6ef0f6
feat(i18n): 补全并修复 EN 翻译，修 translate.py 两处静默丢内容 bug
Charliechen114514 Jun 16, 2026
8be6d41
fix(i18n): 修 EN reading_time 偏差 + 治 06-hal-gpio-output 翻译膨胀
Charliechen114514 Jun 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
11 changes: 11 additions & 0 deletions README.en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
![Tag](https://img.shields.io/github/v/tag/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP?sort=semver&label=tag)
![License](https://img.shields.io/github/license/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
![Build](https://img.shields.io/github/actions/workflow/status/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP/deploy.yml?branch=main)
![AI agent ready](https://img.shields.io/badge/AI%20agent-ready-7C3AED)

---

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

</details>

## Use an AI agent (optional)

This repo is ready for AI coding agents out of the box, and you're welcome to use an agent for learning or contributing:

- 🤖 [AGENTS.md](./AGENTS.md) — vendor-neutral entry point (works with Claude Code / Cursor / Copilot / Codex / …)
- 📚 [Learn C++ with an agent](./.github/learning-with-agents.md) + [common C++ misconceptions FAQ](./.github/faq.md)
- ✍️ Claude-specific assets (writing style / review commands / hooks): see [CLAUDE.md](./CLAUDE.md)

> Not using an agent? Just ignore these files — the main tutorials and examples don't depend on them.

## Contributing

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.
Expand Down
13 changes: 12 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,12 @@
![Tag](https://img.shields.io/github/v/tag/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP?sort=semver&label=tag)
![License](https://img.shields.io/github/license/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
![Build](https://img.shields.io/github/actions/workflow/status/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP/deploy.yml?branch=main)
![AI agent ready](https://img.shields.io/badge/AI%20agent-ready-7C3AED)

---

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

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

</details>

## 用 AI Agent 辅助（可选）

本项目对 AI coding agent 开箱即用，也欢迎用 agent 辅助学习与贡献：

- 🤖 [AGENTS.md](./AGENTS.md) —— 跨 agent 通用入口（Claude Code / Cursor / Copilot / Codex 等都读它）
- 📚 [用 agent 辅助 C++ 学习](./.github/learning-with-agents.md) + [C++ 常见误解 FAQ](./.github/faq.md)
- ✍️ Claude 专属资产（写作风格 / 审查命令 / hooks）见 [CLAUDE.md](./CLAUDE.md)

> 不用 agent？忽略这些文件即可，主线教程与示例不依赖它们。

## 贡献

欢迎修正文档、改进示例、补充章节、校对翻译、提交问题、提出内容建议，或向 [社区文章](https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/community/) 投稿。请先阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。
Expand Down
91 changes: 91 additions & 0 deletions changelogs/v0.6.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
# v0.6.0 (2026-06-16)

内容主线里程碑：卷三「标准库」容器篇完工、迭代器篇起步，卷八「嵌入式」做了一次系统性的内容刷新与归属重组，卷十新增两个 CppCon 2025 笔记系列；平台层完成了站点视觉重做与 Agent 协作接入，并把学习路线图中英双语重写。

## 卷三：标准库重建推进

按 v0.5.0 路线图「012 卷三全面重建」继续推进，本轮新增 15 篇正文，覆盖第一部分（容器）完工与第二部分（迭代器）起步：

**第一部分「容器与内存」完工（14 篇，均含可运行代码，核心章节附真实终端实测）**

- **选型与基础** — 容器选择指南（按操作/内存/失效规则挑容器）、`std::array`、`std::initializer_list`、对象大小/对齐/平凡类型
- **顺序容器深入** — `vector`（三指针/扩容/迭代器失效）、`string`（SSO/COW/`resize_and_overwrite`）、`deque`/`list`/`forward_list`
- **关联容器** — `map`/`set`（红黑树/异构查找/节点句柄）、`unordered_map`/`unordered_set`（哈希表/桶/自定义 hash）
- **视图与适配器** — `std::span`、容器适配器（stack/queue/priority_queue 的包装机制）
- **新标准容器** — `flat_map`、`inplace_vector`、`mdspan`（按 C++23/26 编译器支持度标注）
- **内存** — 自定义分配器与 PMR
- **字符与编码** — `char8_t` 与 UTF-8 字符串

**第二部分「迭代器/算法」起步（1 篇）**

- 迭代器基础与 category：容器和算法靠什么对接

同时执行了 v0.5.0 规划的**归属迁移**：把 `type-safe register`、`circular buffer`、`intrusive containers` 三篇非标准库内容迁出至卷八，让卷三回归「标准库」本位。卷三第二部分余下文章（STL 算法、ranges 进阶等）与第三部分（通用设施/libc++ 源码阅读）仍待后续推进。

## 卷八：嵌入式内容刷新与重组

嵌入式卷在 v0.5.0 已有完整骨架（环境搭建、LED、Button、UART 整条 hands-on 链），本轮做的是系统性**内容刷新 + 归属重组**，而非从零起步：

- 对环境搭建、LED、Button、UART 等章节做了内容修订与统一
- 接收卷三迁入的 type-safe register / circular buffer / intrusive containers 三篇
- 把 Empty Base Optimization 迁出至卷四（归属更贴「高级主题」）
- 新增各章节 landing 索引页，删除已过时的 `array-vs-raw-arrays`

## 卷十：CppCon 2025 笔记扩展

新增两个 Back to Basics 系列（各 3 篇正文 + 导读）：

- **Back to Basics: Ranges** — 从循环到迭代器、STL 算法与迭代器陷阱、ranges views 与组合
- **Back to Basics: Move Semantics** — 拷贝代价与动机、值类别与引用、移动操作/`std::move`/拷贝消除

## 卷四：高级

从卷八迁入 Empty Base Optimization 一文（归属调整）。

## Agent 协作接入

让仓库对 AI 编程助手（Claude Code 等）开箱即用，建立跨 agent 的统一入口与协作约定：

- 新增 **AGENTS.md** 跨 agent 入口与 **CLAUDE.md**，沉淀项目级指令
- 开放 `.claude/` 协作设施：`patch` / `minor` / `new-article` / `audit` / `preflight` / `verify-claim` / `explain` 等命令、写作风格与文档 frontmatter 规则、文章事实核查与严谨度审查 prompt、bare-python 拦截钩子
- 新增 `.github/faq.md` 与 `.github/learning-with-agents.md`，面向读者与贡献者说明如何借助 agent 学习与协作

## 站点视觉重做

首页与内容呈现层做了一次成体系的视觉刷新：

- 新增 `HomeHeroVisual`、`HomeRoadmap` 首页可视化组件
- 新增 `ProofStrip`（实验证据条）、`ScreenshotCarousel`（截图轮播）组件
- 重做 `OnlineCompilerDemo` 在线编译演示
- 引入 shiki 语法高亮、新增 build-info 注入
- 配套移动端阅读修复与整体样式调整

## 学习路线图重写

中英双语重写 `documents/roadmap/index.md`，按稳定信号（主题/难度/前置/平台/成熟度）组织，不堆砌篇数与统计。

## 社区与协作

新增社区/dev 迭代节奏文档与社区入口页，沉淀 patch/minor 迭代约定。

## 内容修复

- filesystem 代码示例细节修正（#45，@YukunJ）
- 修复 filesystem 原子操作章节的错误注释（#46，@YukunJ）

## 翻译

- 同步本版本全部中文内容变更至英文，并对多个卷的英文文档做了批量同步校对

## 贡献者

Charliechen114514、YukunJ

## 内容数据

| 指标 | 数量 |
|------|------|
| 文件变更 | 834 files（+30,566 / -19,870） |
| 提交数 | 15 |
| 合并 PR | #45–#64（共 12 个） |
| 贡献者 | Charliechen114514、YukunJ |
8 changes: 4 additions & 4 deletions documents/en/404.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ tags:
- host
title: Page Not Found
translation:
engine: anthropic
source: documents/404.md
source_hash: 5e0383392a35876a04fd1237a4ab9b52d22c34468522ffe9ee5a8998b76926bc
token_count: 60
translated_at: '2026-05-26T10:08:15.033103+00:00'
source_hash: 23dee62665f54f41a7b8c572196eb6684a0183c2f2c75b625dd0e8d1b91f628d
translated_at: '2026-06-16T03:26:05.272732+00:00'
engine: anthropic
token_count: 64
---
# 404

Expand Down
Loading
Loading