授课进度计划表模板使用说明

模板 ID：jiaoan-jihua

显示名称：授课进度计划表模板

当前版本：1.0.2

适合文档：

• 工学一体化课程授课进度计划；
• 基本技能课程授课进度计划；
• 需要按周次、星期、学时排布的课程实施计划；
• 需要从“学习任务、学习环节、教学内容”生成固定表格的教学文档。

这个模板把结构化 Markdown 转换为“工学一体化课程/基本技能课程授课进度计划表”PDF。你负责写课程元数据、学习任务、学习环节和教学内容；模板负责生成表格标题、元数据区、周次、星期、学时、制表落款和固定审批栏。

MVP Markdown

MVP 是“最小可用输入”。复制下面内容，放进 Presto，选择 jiaoan-jihua 模板，就能得到一份结构完整的授课进度计划表 PDF。

---
major_name: "电气自动化技术"
course_name: "电气设备控制线路安装与调试"
teacher_name: "张老师"
class_name: "29WG 电气 3"
first_teaching_day: "2026-03-06"
template: "jiaoan-jihua"
---

## CA6140 卧式车床电气控制线路安装与调试

### 安技教育及旧知识回顾

安技教育 -1 安技教育及旧知识回顾 -1 常用低压电器元件知识回顾，万用表的使用方法回顾 -1

### CA6140 卧式车床电气控制线路识读

CA6140 卧式车床主电路识读 -4 CA6140 卧式车床控制电路识读 -4 常见电气故障现象分析 -2

### CA6140 卧式车床电气控制线路安装与调试

低压电器元件检测与安装 -4 控制线路布线与通电调试 -6 安全操作记录与质量检查 -2

## X62W 万能铣床电气控制线路安装与调试

### X62W 万能铣床电气控制线路识读

X62W 万能铣床主电路识读 -4 X62W 万能铣床控制电路识读 -4

### X62W 万能铣床电气控制线路安装与调试

控制线路元件布置与接线 -6 线路通电调试与故障排查 -6

PDF 效果：

• YAML 字段生成表格顶部的专业、课程、教师和班级信息；
• 模板根据内置校历推断学年、学期和周次范围；
• ## 生成“学习任务”列；
• ### 生成当前学习任务下的“学习环节”列；
• 普通内容行生成“教学内容”列；
• 内容行末尾的 -数字 解析为学时，并参与周次、星期自动排布；
• first_teaching_day、内置校历和默认每日 8 课时共同决定日期推进和跨周合并；
• 文末自动生成“系主任、教研室主任、制表”固定栏。

结构映射总览

Markdown 输入	PDF 效果
YAML frontmatter	生成表头元数据和排课参数
template: "jiaoan-jihua"	让 Presto 自动选择授课进度计划表模板，不显示在 PDF 中
major_name、course_name	生成表格上方“专业名称、课程名称”
teacher_name、class_name	生成“授课教师、授课班级”
first_teaching_day	作为课程排课起点
## 学习任务名称	新建一个学习任务
### 学习环节名称	新建当前任务下的学习环节
教学内容 -4	生成一条 4 课时教学内容
教学内容	生成一条教学内容，默认 2 课时

Frontmatter 字段

授课进度计划表的封面信息和排课参数都写在 YAML frontmatter 中，不需要在正文里再画表格。

---
major_name: "电气自动化技术"
course_name: "电气设备控制线路安装与调试"
teacher_name: "张老师"
class_name: "29WG 电气 3"
first_teaching_day: "2026-03-06"
template: "jiaoan-jihua"
---

字段说明：

字段	用途
major_name	专业名称；显示在表格上方元数据区
course_name	课程名称；显示在表格上方元数据区
teacher_name	授课教师；显示在元数据区，并优先用于制表落款
class_name	授课班级；显示在表格上方元数据区
first_teaching_day	首个授课日；课程从这一天开始排课
template	模板 ID；让 Presto 自动选择对应模板，不显示在 PDF 中

学年、学期、周次范围、制表人、每日课时和校历均由模板推断或默认。旧输入中的 school_year、semester、week_range、prepared_by、daily_hours、calendar_json 仍兼容，但不建议新文档主动填写。

正文结构

正文从 ## 开始。推荐按“学习任务 → 学习环节 → 教学内容”组织：

## CA6140 卧式车床电气控制线路安装与调试

### 安技教育及旧知识回顾

安技教育 -1

安技教育及旧知识回顾 -1

常用低压电器元件知识回顾，万用表的使用方法回顾 -1

写作约定：

• ## 新建一个学习任务；
• ### 新建当前任务下的学习环节；
• ### 必须出现在某个 ## 下面；
• 普通内容行进入“教学内容”列；
• 内容行末尾的 -数字 会被解析为课时，例如 控制线路布线与通电调试 -6；
• 没有写 -数字 的内容行默认按 2 课时处理；
• 不需要手写周次、星期和日期，模板会根据排课规则自动计算。

排课规则

first_teaching_day 是课程排课起点。模板会从这个日期开始，结合内置学校校历和每日 8 课时容量，把教学内容逐条排入表格。

字段	排课影响
first_teaching_day	决定从哪一天开始排课
内置校历第一天	决定学年、学期和第 1 周锚点
默认每日课时	每天最多容纳 8 课时

模板内置校历。兼容旧输入中的外部日历 JSON，推荐使用只包含上课日期的数组：

["2026-03-06", "2026-03-07", "2026-03-09"]

如果旧输入里的 calendar_json 指向的文件不存在，模板会回退到内置校历；如果 JSON 无效，PDF 中会显示提示并回退。

常见写法

一项内容占多个课时

控制线路布线与通电调试 -6

PDF 效果：生成一条 6 课时教学内容；如果当天剩余课时不足，模板会自动延续到后续工作日。

不写课时

安全操作记录与质量检查

PDF 效果：按默认 2 课时处理。

多个学习任务

## CA6140 卧式车床电气控制线路安装与调试

### 控制线路识读

主电路识读 -4

## X62W 万能铣床电气控制线路安装与调试

### 控制线路识读

主电路识读 -4

PDF 效果：两组学习任务按输入顺序进入同一张授课进度计划表，并连续排课。

检查清单

导出前建议确认：

• YAML 中写了 template: "jiaoan-jihua"；
• first_teaching_day 使用 YYYY-MM-DD 格式；
• 每个 ### 学习环节前面都有对应的 ## 学习任务；
• 教学内容课时使用半角连字符，例如 内容 -2。