1
0

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:
2026-03-03 16:33:10 +08:00
parent 01eacb0b97
commit 01a93ce13b
14 changed files with 710 additions and 2 deletions

View File

@@ -78,6 +78,15 @@ def validate_presentation_yaml(data, file_path=""):
if not isinstance(data['slides'], list):
raise YAMLError(f"{file_path}: 'slides' 必须是一个列表")
# 验证每个幻灯片的 enabled 字段
for i, slide in enumerate(data['slides']):
if isinstance(slide, dict) and 'enabled' in slide:
if not isinstance(slide['enabled'], bool):
raise YAMLError(
f"{file_path}: slides[{i}].enabled 必须是布尔值true 或 false"
f"不支持字符串或条件表达式"
)
# 验证 templates 字段(内联模板)
validate_templates_yaml(data, file_path)