feat: 添加页面级 enabled 参数支持幻灯片启用/禁用控制
添加页面级 enabled 布尔参数,用于临时禁用整个幻灯片,无需删除或注释 YAML 内容。
与元素级 visible 条件渲染独立工作,提供两层控制机制。
主要变更:
- 在 yaml2pptx.py 主循环中检查 enabled 参数,跳过禁用的幻灯片
- 实现独立的 slide_index 计数器,准确统计实际渲染的幻灯片数量
- 在 yaml_loader.py 中添加 enabled 字段验证,确保类型为布尔值
- 添加 11 个测试用例,覆盖各种使用场景
- 更新 README.md 和 README_DEV.md 文档,说明 enabled 和 visible 的区别
- 创建新的 slide-enabled-control capability 规范
- 更新 template-system 规范,添加 enabled 字段支持
使用示例:
slides:
- template: title-slide
vars:
title: "正常页面"
- enabled: false
template: work-in-progress
vars:
title: "临时禁用的页面"
测试:所有 282 个单元测试通过
This commit is contained in:
@@ -75,7 +75,13 @@ yaml2pptx.py (入口)
|
||||
- `/// script` 依赖声明
|
||||
- `parse_args()` - 命令行参数解析
|
||||
- `main()` - 主流程编排
|
||||
- `handle_convert()` - 转换流程,包含页面级 `enabled` 检查
|
||||
- **不包含**:业务逻辑、数据处理
|
||||
- **enabled 实现细节**:
|
||||
- 在主渲染循环中检查 `slide_data.get('enabled', True)`
|
||||
- 跳过 `enabled=false` 的幻灯片,不调用 `render_slide()`
|
||||
- 维护独立的 `slide_index` 计数器,只统计实际渲染的幻灯片
|
||||
- 进度日志显示准确的渲染数量(不包括禁用的幻灯片)
|
||||
|
||||
### 2. utils.py(工具层)
|
||||
- **职责**:通用工具函数
|
||||
@@ -88,12 +94,13 @@ yaml2pptx.py (入口)
|
||||
- **包含**:
|
||||
- `YAMLError` - 自定义异常
|
||||
- `load_yaml_file()` - 加载 YAML 文件
|
||||
- `validate_presentation_yaml()` - 验证演示文稿结构,调用 `validate_templates_yaml()` 验证内联模板
|
||||
- `validate_presentation_yaml()` - 验证演示文稿结构,调用 `validate_templates_yaml()` 验证内联模板,验证幻灯片 `enabled` 字段
|
||||
- `validate_template_yaml()` - 验证外部模板结构
|
||||
- `validate_templates_yaml()` - 验证内联模板结构(templates 字段)
|
||||
- **特点**:
|
||||
- 内联模板验证包括:结构验证、元素验证、变量定义验证、默认值验证
|
||||
- 检测默认值中引用不存在的变量
|
||||
- 验证 `enabled` 字段必须是布尔值,拒绝字符串或条件表达式
|
||||
|
||||
### 4. core/elements.py(核心层 - 元素抽象)
|
||||
- **职责**:定义元素数据类和工厂函数
|
||||
|
||||
Reference in New Issue
Block a user