先补课程页
新增知识点时,优先更新对应的 courses/content/*.html 源文件,再运行 python3 build.py 重新生成 public/courses/*.html。
Resources
这里保留运行、练习、部署和维护相关内容,避免用户从站点跳到未排版的 Markdown 文档。
项目是纯静态网站,不需要构建工具。启动本地服务后访问根路径即可。
python3 -m http.server 8788
# 打开 http://localhost:8788
安装依赖后,可以运行 examples/ 目录中的脚本练习分类、回归、聚类和预处理流程。
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python examples/classification_pipeline.py
python examples/regression_pipeline.py
python examples/clustering_pca.py
python examples/preprocessing_pipeline.py
python examples/naive_bayes_spam.py
python examples/svm_digits.py
python examples/ensemble_methods.py
examples/end_to_end_project/ 串联数据加载、EDA、预处理、训练、评估、模型保存与预测六个环节,是一个完整的分类项目示例。
cd examples/end_to_end_project
python train.py
python predict.py
| 路径 | 用途 |
|---|---|
public/index.html | 宣传首页和核心课程转化入口。 |
public/courses.html | 课程目录、学习路线和常用资源入口。 |
public/courses/ | 十四个课程章节的编译输出(由 build.py 生成)。 |
public/glossary.html | 常用机器学习术语的定义与章节索引。 |
public/styles.css | 站点视觉系统和响应式布局。 |
public/app.js | 导航、进度、复制代码和 Canvas 可视化交互。 |
courses/content/ | 章节内容源文件(未编译片段),由 build.py 读取。 |
examples/ | 可运行的 scikit-learn 示例脚本(本地克隆运行,不部署到线上)。 |
examples/end_to_end_project/ | 完整的端到端分类项目(客户流失预测)。 |
该项目没有构建命令;public/ 目录就是构建输出目录,只有这里的文件会被部署上线。
仓库根目录下的 README.md、TODO.md、openspec/、scripts/、courses/content/、examples/ 等都只是源文件或开发工具,不在 public/ 里,因此永远不会被发布,无需为它们额外配置屏蔽规则。新增网站页面时把编译产物放进 public/,新增内部文档/脚本放在仓库其他地方即可保持这个边界。
新增知识点时,优先更新对应的 courses/content/*.html 源文件,再运行 python3 build.py 重新生成 public/courses/*.html。
如果新增的是一级学习模块,同步更新 public/courses.html 的目录入口。
涉及可运行代码时,把可复用示例放进 examples/。