Digital IC Classroom
← 课程目录工程参考下载 Markdown ↓

Digital IC Classroom 学习网站

独立 Astro 静态网站，正式地址：Digital IC Classroom。 模拟课堂的首页和共享导航设有“数字 IC 课堂”入口；本站导航与页脚可返回 Circuits & Systems Classroom。

内容与记录

  • 直接读取 原有课程，生成六个方向、94 课的目录、讲义、参考答案与项目页面，不复制维护讲义正文。
  • 课程目录支持标题与正文搜索；阅读页有课程导航、本页目录、源码阅读和个人记录。
  • 学习状态与笔记使用当前浏览器 localStorage。可导出 JSON 备份、导入合并；同一课以导入记录为准。没有账号或云端同步。
  • SPI 交互演示使用 50 MHz clk，展示 Mode 0、MSB first、独立 TX/RX、分频 1/3/25 和八次采样；属于契约生成的理想教学模型，不替代真实 RTL 回归。
  • Git 忽略的 VCD/SVG/报告链接转到本地产物说明页，不将生成产物、安装工具、官方教程库、许可或 PDK 上传网站。

本地开发

Node ≥22.12、pnpm 11，在 web/ 运行：

pnpm install --frozen-lockfile
pnpm dev
pnpm check
pnpm test
pnpm build
pnpm test:browser

开发与预览地址为 http://127.0.0.1:4322，浏览器测试用独立前台进程和端口 4323。首次浏览器测试可运行 pnpm exec playwright install chromium；已有 Chromium 可通过当前命令环境的 PLAYWRIGHT_EXECUTABLE_PATH 复用，配置不写入机器专属路径。

模型/数据测试覆盖课程编号和锚点、Markdown 链接、SPI 全部 256 码与三组分频、学习备份校验与合并；浏览器测试覆盖搜索、阅读导航、笔记持久化、备份、SPI 控件及手机布局。

Cloudflare Pages 发布

node scripts/deploy-pages.mjs --prepare-only
node scripts/deploy-pages.mjs

先构建并在 .wrangler/static-pages-* 中准备隔离静态产物，再使用已有 Pages 登录创建或复用 why250-digital-ic-classroom。需要登录时使用 node node_modules/wrangler/bin/wrangler.js login --device --browser=false --scopes account:read user:read pages:write；凭据始终由 Wrangler 保存在源码之外。

项目名可用 --project <name> 修改；构建时 SITE_URL 随之更新 canonical / sitemap。Cloudflare 部署成功后仍需检查正式网址与模拟课堂跳转。发布不自动提交或推送 Git。

根目录的 EDA 部署工具 tools/deploy.ps1 排除 web/，保留原有普通 scp 与逐文件 SHA-256 核验。网页使用上述独立 Pages 流程发布，不上传到 IC_Server。

兄弟网站的目标地址集中在其 web/src/data/learning-sites.ts，可用 DIGITAL_IC_SITE_URL 环境变量覆盖。本站正文、路线与证据继续分别维护在 docs 下的原文件。