将 README.md 拆分为多个专题文档,减少认知负荷: - 用户文档迁移到 docs/ (用户指南、元素、模板、参考等) - 开发文档迁移到 docs/development/ (架构、模块、规范) - README.md 精简至 ~290 行,仅保留概览和导航 - 删除 README_DEV.md,内容已迁移 - 归档 OpenSpec 变更 refactor-docs-progressive-disclosure
49 lines
1.8 KiB
Markdown
49 lines
1.8 KiB
Markdown
# yaml2pptx 文档
|
|
|
|
欢迎使用 yaml2pptx 文档!本目录包含项目的完整文档。
|
|
|
|
## 用户文档
|
|
|
|
### 快速开始
|
|
- [用户指南](user-guide.md) - 完整的使用指南
|
|
|
|
### 元素类型
|
|
- [文本元素](elements/text.md) - 文本框和字体配置
|
|
- [图片元素](elements/image.md) - 图片插入和配置
|
|
- [形状元素](elements/shape.md) - 几何形状绘制
|
|
- [表格元素](elements/table.md) - 表格创建和样式
|
|
|
|
### 模板系统
|
|
- [内联模板](templates/inline.md) - 在源文件中定义模板
|
|
- [外部模板库](templates/external-library.md) - 独立的模板库文件
|
|
- [混合模式](templates/mixing-mode.md) - 模板与自定义元素组合
|
|
- [条件渲染](templates/condition-rendering.md) - 元素和页面的条件显示
|
|
|
|
### 其他主题
|
|
- [字体主题系统](fonts.md) - 字体配置和主题管理
|
|
- [示例集合](examples.md) - 实战示例
|
|
- [故障排查](troubleshooting.md) - 常见问题解决
|
|
|
|
### API 参考
|
|
- [命令行选项](reference/commands.md) - 所有命令和参数
|
|
- [坐标系统](reference/coordinates.md) - 位置和尺寸单位
|
|
- [颜色格式](reference/colors.md) - 颜色表示方法
|
|
- [验证功能](reference/validation.md) - YAML 验证说明
|
|
|
|
## 开发文档
|
|
|
|
详见 [development/](development/) 目录。
|
|
|
|
- [架构设计](development/architecture.md) - 代码结构和技术决策
|
|
- [模块详解](development/modules/) - 各模块详细说明
|
|
- [字体系统](development/font-system.md) - 字体解析实现
|
|
- [作用域系统](development/scope-system.md) - 字体作用域规则
|
|
- [开发规范](development/development-guide.md) - 编码规范和约定
|
|
- [扩展指南](development/extending.md) - 添加新功能
|
|
- [测试规范](development/testing.md) - 测试指南
|
|
- [维护指南](development/maintenance.md) - 代码审查和优化
|
|
|
|
---
|
|
|
|
返回 [项目主页](../README.md)
|