Course Nav Updates Implementation Plan
Course Nav Updates Implementation Plan
For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
Goal: 为“数值计算”“数理统计”页面添加锚点子导航,并新增引用外部笔记的“计算机网络”课程页,统一使用侧边栏折叠逻辑。
Architecture: 利用 _data/navigation.yml 的 course_nav 列表定义子链接,页面内在二级标题后添加显式锚点 <a id="...">;复用 _includes/nav_list 的前缀展开逻辑;新增网络页面读取外部 md 内容并设置导航。
Tech Stack: Jekyll (Liquid), Markdown, YAML。
Task 1: 补充数值计算页面锚点
Files:
- Modify:
_pages/course-numerical-calculation.md
Step 1: 为每个二级标题(去掉“第X章”前缀)添加 <a id="...">,id 使用英文短名如 valid-digit, root, linear, interpolation, integration, ode。
Step 2: 确认同名 ## 标题下内容保持不变,其后紧跟一个空格再放锚点。
Step 3: 自查 Markdown 预览无格式断裂。
Task 2: 更新导航数据加入数值计算子项
Files:
- Modify:
_data/navigation.yml
Step 1: 在 course_nav -> “数值计算”节点下添加 children 数组,对应 Task1 的锚点 URL(/course/numerical-calculation/#root 等,顺序与页面段落一致)。
Step 2: 检查缩进和引号,保持与其他课程一致。
Task 3: 补充数理统计页面锚点
Files:
- Modify:
_pages/course-statistics.md
Step 1: 为所有二级标题添加锚点 id:sampling, estimation, hypothesis, regression 等,放在标题行末 <a id="..."></a>。
Step 2: 确保数学公式未受影响。
Task 4: 更新导航数据加入数理统计子项
Files:
- Modify:
_data/navigation.yml
Step 1: 在 “数理统计” 节点下添加 children,URL 指向 /course/statistics/#sampling 等,对应 Task3。
Step 2: 运行 YAML 语法自检(目测缩进)。
Task 5: 添加计算机网络页面
Files:
- Create:
_pages/course-network.md - Modify:
_data/navigation.yml
Step 1: 创建页面 front matter,设置 permalink: /course/network/、sidebar.nav: "course_nav"、mathjax:false、toc:true。
Step 2: 引入 /mnt/f/file/Network/Note/review.md 内容(保持原始列表前后空行),确保列表项后留空行以符合提示。
Step 3: 页面二级标题添加锚点(若原文缺少,按章节补充)。
Step 4: 在导航中新增 “计算机网络” 节点及子导航(若有明确章节则列出锚点;否则先只加父链接)。
Task 6: 验证
Files:
- Inspect:
_includes/nav_list
Step 1: 目测核对折叠逻辑已满足,无需改动模板。
Step 2: 本地不跑构建;若需,可运行 bundle exec jekyll build(暂略)。
