PPT管理
PPT 维护¶
ppt 维护使用文档，是为了方便助教维护管理与 PPT 资料相关的内容。
使用场景¶
- 某个阶段批量更新。
- PPT 内容错误。
- 知识模块关联的 PPT 不对应。
- 新增一个单独的 PPT 卡片。
- 章节的 PPT 新增（资料服务）。
更新方式¶
批量更新¶
功能说明¶
基于资料服务已有的 ppt 资源基础上，将其绑定给已经建好的但缺少 ppt 的课程上，从而实现关联。
步骤说明¶
详细步骤¶
-
更新资料服务(注意，这个步骤是大前提)
-
跟进讲师编写好 ppt，并提交到 main 分支
- 进入资料服务系统进行文件更新操作，更新操作地址：https://material.hogwarts.ceshiren.com/cover/update?class=xxx
-
进行 ppt 的 html 的生成操作，生成 ppt 地址：https://material.hogwarts.ceshiren.com/cover?class=xxx
-
获取学员系统课程 id 和阶段的
id（数字格式） -
登录 V2 版本学员系统，在“我的课程”中找到需要绑定 ppt 的课程学员系统的课程 id 为 url 中资源路径的末端。
-
进入课程详情页，打开开发者工具 F12，刷新页面，查看与课程标识同名的接口，查看 sections 数组中对应阶段的 id。
-
访问资料服务页面，所展示的都是有效的阶段标识，找到目标阶段对应的英文名称。例如阶段“Linux 与 Bash”对应的阶段标识为“bash_script”，此映射关系需要助教同学熟记。注意：！！！一定要确定资料服务更新数据的正确性，如果不正确，则重新更新下数据，或者找讲师确认。资料服务地址：https://material.hogwarts.ceshiren.com/section
-
构建 Jenkins 任务
-
进入 Jenkins 的 job，Jenkins 的，job 地址：点击链接访问
- 点击“Build with Parameters”。
-
输入参数: 参数 script_name 下拉列表中选择“bind_ppt”，在 script_params 文本框中按照指定格式“阶段 id||资料服务阶段标识”填写数据。例如“262076||bash_script”。
-
刷新缓存，构建完成之后，需要刷新课程的缓存信息。 需要对用到此章节的课程进行刷新操作，刷新使用的课程 id 来源于第 2 步骤
PPT 批量关联失败（名称匹配不上）¶
功能说明¶
在做批量同步操作的时候，发现批量同步有部分同步失败，日志分析后发现是ppt的名称与学员系统的卡片不匹配
步骤说明¶
详细步骤¶
重新操作批量更新的详细步骤1~5
PPT 内容错误（链接无变化）¶
功能说明¶
在助教检查系统的 ppt 的时候，发现了内容有错误，仅需要更新 ppt 的内容，不需要更新关联关系
步骤说明¶
详细步骤¶
- 更新资料服务 参照批量更新的详细步骤的第一个步骤
PPT 内容错误（链接有变化）¶
功能说明¶
在助教检查系统的 ppt 的时候，发现了内容有错误，需要更新 ppt 的内容及关联关系
步骤说明¶
详细步骤¶
- 更新资料服务 参照批量更新的详细步骤 1
- 在学员系统的页面打开开发者的网络页签，找到 ppt 的 id
- 在学员系统后端接口使用 ppt 的 id 进行 ppt 更新操作
- 刷新缓存 参照批量更新的详细步骤 5
知识模块关联的 PPT 不对应¶
功能说明¶
在助教检查系统的 ppt 的时候，发现了内容关联错误，仅需要更新的关联关系
步骤说明¶
详细步骤¶
- 进入资料服务中，找到正确的 ppt 的链接地址
- 在学员系统后端进行 ppt 的修改操作 参考 PPT 内容错误（链接有变化）详细步骤 3
- 刷新缓存 参照批量更新的详细步骤 5
新增一个单独的 PPT 卡片¶
功能说明¶
某些时候，例如某个营销课程需要外放一个 ppt
步骤说明¶
详细步骤¶
- 更新资料服务 参照批量更新的详细步骤 1
- 在学员系统开发环境上添加 ppt，此时会返回 ppt 的 id
- 在学员系统的页面打开开发者的网络页签，找到章节的 id
- 在学员系统开发环境上使用章节 id 和 ppt 的 id 进行直播关联即章节的更新操作
- 刷新缓存 参照批量更新的详细步骤 5
章节的 PPT 新增（资料服务）¶
-
注意：这部分内容通常由讲师完成，除非特殊情况，建议由助教敦促讲师完成
-
在 Book 中，点击链接找到自己要更新的模块。比如 performance 就是性能。
- 点击对应的子模块进入目录。将项目 clone 下来。
- 然后将 PPT 更新到对应目录下面。注意 PPT 更新的规则，目录一定要与大纲的级别、编程语言对应。
- 注意，一定要在本地分支修改之后，走 MergeRequest 的方式合入到 main 分支。
- 合入成功之后，则参考 【更新资料服务(注意，这个步骤是大前提)】之后继续更新PPT即可。