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.ymlcourse_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:falsetoc: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(暂略)。