用途:该技能用于脚手架化并指导创建 H5P 内容类型,适用于“构建 H5P 类型”“创建 H5P 内容类型”“脚手架化 H5P 库”等场景。
主要能力:选择打包意图(library-install 默认,或 content-import 高级);收集元数据(标题、机器名、版本、作者、许可证);从模板生成样板(默认 SNORDIAN);提供 library.json、semantics.json 及 JS/CSS 入口;概述使用 h5p-cli 的构建与打包步骤。概念上,内容类型是 H5P.* 下可运行库(runnable: 1),编辑器组件是 H5PEditor.* 下不可运行库(runnable: 0),semantics.json 定义编辑器表单模式与校验规则。
使用方式:运行 scaffold.sh 并传入 --title、--machine、--kind、--version、--description、--author、--license、--template、--out 等参数;编辑器组件示例使用 --kind editor 与 H5PEditor.* 机器名。构建打包:npm install、npm run build、h5p setup <library>、h5p server、h5p pack <library> [my-library.h5p]。上传前可用 scripts/validate-package.sh 校验,严格打包用 scripts/pack.sh。
适用场景:为 LMS/CMS 平台创建可安装的 H5P 库或编辑器组件,常见教育内容类型包括 Interactive Video、Course Presentation、Question Sets 等。
限制:该技能只脚手架化库,不生成 content/content.json;库包应保持 library.json 在根目录,避免顶层 h5p.json 或 content/;Drupal 11.x H5P 2.0.0 beta 可能拒绝含目录条目的 zip,需用 pack.sh 重新打包。模板包括 snordian、vanilla、editor,另有未捆绑的上游选项。若机器名无效,使用 H5P.YourContentType;版本不明可从 1.0.0 开始;构建失败需确保 node 和 npm 已安装并运行 npm install。