v0.4.0, Great Update of Surfing Site; v0.4.0——站内浏览的提升版本

v0.4.0 (2026-05-26)

第三次功能版本更新：英文站点完整落地、Compiler Explorer 交互代码集成、Mermaid/DrawIO 图表渲染、指针语义深度示例，以及仓库瘦身清理。

新增内容

英文站点完整落地

英文翻译从零散状态升级为完整可用站点，覆盖所有核心卷：

• 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）