支持在 YAML 源文件中直接定义模板,无需单独的模板文件。 简化单文档编写流程,降低模板系统使用门槛。 核心功能: - 在 YAML 顶层新增 templates 字段定义内联模板 - 支持变量替换、条件渲染、默认值等完整模板功能 - 内联模板优先于外部模板查找 - 同名冲突检测:禁止内联和外部模板同名 - 相互引用检测:禁止内联模板之间相互引用 - 完整的错误处理和验证机制 代码变更: - core/template.py: 新增 from_data() 类方法 - core/presentation.py: 支持内联模板查找和冲突检测 - loaders/yaml_loader.py: 新增 validate_templates_yaml() 验证 - validators/: 扩展验证器支持内联模板 测试: - 新增 9 个内联模板专项测试 - 修复 1 个变量验证测试 - 所有 333 个测试通过 文档: - README.md: 添加内联模板使用指南和最佳实践 - README_DEV.md: 说明实现细节和设计决策 完全向后兼容,不使用 templates 字段时行为不变。
24 lines
374 B
YAML
24 lines
374 B
YAML
vars:
|
|
- name: title
|
|
required: true
|
|
- name: subtitle
|
|
required: false
|
|
default: ""
|
|
|
|
elements:
|
|
- type: text
|
|
box: [1, 2, 8, 1]
|
|
content: "{title}"
|
|
font:
|
|
size: 44
|
|
bold: true
|
|
align: center
|
|
|
|
- type: text
|
|
box: [1, 3.5, 8, 0.5]
|
|
content: "{subtitle}"
|
|
visible: "{subtitle != ''}"
|
|
font:
|
|
size: 24
|
|
align: center
|