SuperAPI AI 工具集

course-ebook-publishing

办公与效率

查看项目

更新于 10-16 06:22

技能介绍

用途:把已完成的课程教学网站转成书籍形态,生成可打印、可归档、可分享的成品。仅在站点功能完整、内容稳定后使用;站点开发中不要调用。

主要能力:以 Live window.COURSE 为单一数据源,经 compose-ebook.mjs 合成 master.md,再分别用 pandoc 输出 DOCX、用 Playwright page.pdf() 输出 PDF,保证两种格式内容一致。支持封面、目录、章节、材料附录与技能链接附录;可输出 dist/{name}.pdf 与 dist/{name}.docx。

使用方式:运行 scripts/build-ebook.mjs,支持 --md-only、--no-docx、--no-pdf、--keep-html、--output PATH。站点用外部 course-data.js 时直接导入;内联 COURSE 时用正则加 vm 沙箱提取。PDF 用 Playwright 生成以支持页码;DOCX 用 pandoc 加 --reference-doc 模板;图片用相对路径配合 --resource-path。

过滤规则:测验题目、前测/后测内容不入书;仅交互功能(如复制按钮)改为呈现原文;canvas/JS 动态插图不渲染。样式上可用 @page :first { margin: 0 } 让封面不显示页码;DOCX 对原始 HTML 支持有限,图组会降级为纵向排列,建议用 markdown 图片语法。生成后可用 verify-ebook.mjs 校验文件大小、封面页码、目录与图片解析。

限制:仅消费 window.COURSE,不重新撰写内容;DOCX 中 HTML 支持不完整;封面页码、图表排版等细节需人工核对。部分实现细节资料未完整提供。