release: v0.4.0

Author: Charliechen114514

changelogs/v0.4.0.md

@@ -0,0 +1,86 @@
+# v0.4.0 (2026-05-26)
+
+第三次功能版本更新：英文站点完整落地、Compiler Explorer 交互代码集成、Mermaid/DrawIO 图表渲染、指针语义深度示例，以及仓库瘦身清理。
+
+## 新增内容
+
+### 英文站点完整落地（+4,005 行，68 个文件）
+
+英文翻译从零散状态升级为完整可用站点，覆盖所有核心卷：
+
+- **Compilation 卷**：10 篇 + index，静态/动态库、符号可见性、运行时加载全量翻译
+- **C++ Reference**：concurrency（4 篇）、containers（10 篇）、core-language（18 篇）、memory（5 篇）、templates（3 篇）及各 index
+- **Vol.1 Fundamentals**：preface、C 语言速成、C++98 系列（6 篇）、语言选型等
+- **Vol.2 Modern Features**：多篇现代特性文章翻译
+- **站点页面**：404 页、appendix/terminology、team、tags、projects、index
+
+### Compiler Explorer 交互代码集成（#24）
+
+新增 `code/examples/compiler_explorer/`，支持在线修改编译条件并实时查看汇编输出：
+
+- 14 个示例，覆盖 ARM / Host 双平台
+- 主题包括：`array` vs C 数组、`constexpr`、EBO、`placement new`、静态多态、结构体对齐、编译器选项、GPIO 零开销抽象等
+
+### 指针语义深度示例（#28）
+
+新增 `code/examples/cpp-deep-dives/pointer-semantics/`，从零实现并测试多种指针语义类型：
+
+- `borrowed_ptr`、`observer_ptr`：借用与观察语义
+- `weak_ptr`、`simple_weak_ptr`、`unsafe_weak_ptr`：弱引用与生命周期验证
+- `weak_flag`、`weak_ptr_factory`：配套设施
+- 含完整 CMakeLists.txt 及 4 组单元测试
+
+### 并发练习手册（#31）
+
+- 新增 `vol5-concurrency/exercises/index.md`，中英文双语同步上线
+
+### Vol.4 模板编程索引重构
+
+- 清理草稿文章后，新增 `vol4-advanced/vol2-modern-cpp17/index.md` 作为模板编程入口
+
+## 站点增强
+
+### Mermaid 图表渲染（#28）
+
+- 新增 `site/.vitepress/plugins/mermaid-plugin.ts` 构建时插件
+- 新增 `site/.vitepress/theme/mermaid-client.ts` 客户端运行时
+- Markdown 内 Mermaid 代码块可在站点中直接渲染
+
+### DrawIO 图表渲染（#30）
+
+- 新增 `site/.vitepress/theme/custom.css`（+353 行），支持 DrawIO 嵌入样式
+- 部分原有 Mermaid 图表迁移为 DrawIO 渲染
+
+## 仓库清理
+
+### 草稿与模板删除
+
+- 删除 `documents/vol4-advanced/` 下 5 篇未完成草稿（-3,300 行）：template-overview、function-templates、class-templates、if-constexpr、cpp-templates-index
+- 删除 `.templates/` 目录（article / platform-tutorial / reference-card / todo 模板）
+- 删除 `.githooks/pre-commit`（迁移至 pre-commit）
+
+### TODO 瘦身
+
+- 清理 todo 目录 46 个文件（-6,160 行），移除已归档和过时条目
+
+## 工程改进
+
+- Hooks 迁移至 `.pre-commit-config.yaml`，统一使用 pre-commit 框架
+- 更新 `scripts/setup_precommit.sh` 适配新 hook 配置
+- `scripts/build.ts`：适配 Mermaid 插件集成
+- `scripts/check_links.py`：增强链接可达性检查
+- `scripts/validate_frontmatter.py`：校验规则更新
+- `scripts/cppref_card_generator.py`：卡片生成器适配
+- 修复 CI 脚本错误（#30）
+- 修复文档 404 URL（#26）
+- 中文文章批量添加 Compiler Explorer 交互链接（vol1 多章、vol3、vol7）
+
+## 内容数据
+
+| 指标 | 数量 |
+|------|------|
+| 文件变更 | 692 files（+34,749 / -46,491） |
+| 英文翻译文件 | 68 个新增/修改 |
+| 交互代码示例 | 14 个（Compiler Explorer） |
+| 指针语义示例 | 8 个头文件 + 4 组测试 |
+| 净删除 | ~11,700 行（仓库瘦身） |