v0.10.0 - Homepage Showcase
Release Notes: v0.10.0 - Homepage Showcase
Tag: v0.10.0-homepage-showcase
Title: v0.10.0 - Homepage Showcase
Date: 2026-07-01
Overview
本次发布完成 V10A：首页视觉升级 + 全站 Showcase 化。把内容丰富但偏文档型的站点升级为作品集型学习站，使访问者打开首页后能立刻理解项目是什么、学习路线、有哪些实操线、有哪些 Capstone / CadQuery / Assembly / Portfolio 成果。
What's New
新增页面
| 文件 | 说明 |
|---|---|
project-showcase.rst |
项目全景页（A-I 结构）：项目起源、模块清单、演进时间线、Showcase 入口表、适合读者、后续规划 |
首页 index.rst 视觉升级
新增以下区块：
- A. Hero 区块 — 项目一句话定位 + 当前版本 + GitHub Pages / GitHub Repo / Release / Showcase 入口
- B. 六大入口 — 课程基础 / FreeCAD 实操线 / 工程案例 / Capstone 项目线 / CadQuery 代码建模 / Assembly 装配体线 / Runtime-Portfolio 收口线
- C. 推荐阅读路径 — 5 种读者类型的明确入口（零基础 / 实操派 / 作品集派 / 代码派 / 装配派）
- D. 项目能力矩阵 — 8 大能力模块 + 覆盖内容 + 对应页面 + 成熟度
- E. v1.0 前路线图 — V10A → V10B → V10C → v1.0.0 路线
- 保留原有"快速入口"和"如何使用本站"
新增 SVG 图示
| 文件 | 说明 |
|---|---|
_static/diagrams/site-showcase-map.svg |
站点全景图：课程基础 → FreeCAD → Capstone → CadQuery → Assembly → Portfolio |
_static/diagrams/v1-roadmap.svg |
v1.0 Roadmap：从 v0.9.x 到 V10A Showcase → V10B Quality Audit → V10C Release Closure → v1.0.0 Stable |
新增 CSS 样式
| 文件 | 说明 |
|---|---|
_static/css/showcase.css |
轻量 CSS：Hero / entry-card / path-card / roadmap-block / timeline 等样式 |
配置：在 conf.py 中追加 html_css_files = ['css/showcase.css']
特点：
- 不破坏 Furo 默认主题
- 不引入外部字体或外部 CSS
- 不依赖 JavaScript
- 仅改善首页和 project-showcase 页的视觉层次
现有页面更新
| 文件 | 更新内容 |
|---|---|
conf.py |
新增 html_css_files 配置（追加 showcase.css） |
workflow-roadmap.rst |
轻量加入 project-showcase 入口说明（"下一步建议"区块 + 末尾"项目全景补充"） |
examples/index.rst |
新增"从 Showcase 开始"区块 + 6 大分组入口 |
README.md |
项目一句话定位 + 状态表 + 9 项快速入口表 + 完整能力矩阵（追加 V10A）+ V10A 教学亮点 + v1.0 Roadmap |
Build & Verification
| 项目 | 结果 |
|---|---|
| Build Command | sphinx-build -b html -W --keep-going . _build/html |
| Build Result | ✅ succeeded |
| Warning Count | 0 |
| py_compile code/cadquery/*.py | ✅ 6/6 OK |
| py_compile scripts/cadquery/*.py | ✅ 4/4 OK |
| showcase.css XML/CSS 加载 | ✅ link 标签存在于 index.html |
| SVG XML 解析 | ✅ 2/2 OK |
| project-showcase.html 生成 | ✅ |
| index.html Hero + 入口 + 矩阵 + 路线图 | ✅ 全部存在 |
Teaching Notes
- 不新增大型课程内容
- 不重写 unit1~unit8
- 不破坏 V5/V6/V7/V8/V9 页面
- 不引入后端、数据库或复杂前端
- 保持 Sphinx + Furo 静态站路线
- 轻量 CSS 仅改善视觉层次，不破坏 Furo 默认主题
- 2 个新 SVG 全部本地，无外部依赖
- 构建保持 0 warning
后续规划
- V10B：全站质量审计（链接失效检查、死链排查、Sphinx 0 warning、HTML/CSS 验证、SVG 引用检查）
- V10C：最终发布收口（README 最终版、release notes、导航/标签收口）
- v1.0.0：稳定版发布（长期支持里程碑）
Released by OpenClaw Agent (longxia2) on 2026-07-01.