← 返回课件空间

GUIDE / HELP

一个可以不断添加课件的网站

课程资料按照课程文件夹管理。支持 PDF、PPTX 和旧版 PPT。PPT/PPTX 会自动转换成用于网页预览的 PDF 和 JPEG，原始文件仍会保留。

① 查看已导入的课件

打开 index.html 即可离线浏览；也可以运行本地服务器，访问 http://localhost:8000。使用左侧课程目录筛选，搜索栏可以检索页面标题与部分自动提取的文字。

② 增加新课程或新课件

在项目的 site/library/ 下创建新课程文件夹，把 PDF / PPT / PPTX 放进去：

site/library/
  RAI605-MACHINE LEARNING/
    L01 机器学习概述.pdf
  RAI606-MY NEW COURSE/
    第一讲.pptx
    第二讲.pdf

在项目根目录运行以下命令即可更新索引和截图。已有文件默认复用缓存，只有新加入或修改的课件需要重新处理。

pip install -r requirements.txt
python tools/build_library.py --site site

也可以直接增量导入新的 ZIP：

python tools/build_library.py --site site --add-zip NewLesson.zip

课件目录内每个课程应该有独立的子文件夹。PDF 可以直接浏览；PPT/PPTX 转换需要本机安装 LibreOffice，并能够运行 libreoffice 命令。

③ 更改课程显示名称

修改项目的 config/course_metadata.json。没有配置的课程会自动使用文件夹名称，不会阻止新课程导入。

④ 把网站部署成网址

这是静态网站，没有数据库或服务端账号。可以使用 GitHub Pages 或 Cloudflare Pages 托管整个 site/ 文件夹。项目自带 GitHub Actions 部署工作流。

提醒：课程 PPT/PDF 可能涉及教师、学校或第三方版权。部署公开网站之前，应先确认课件允许公开分享；否则建议限制访问或只在个人设备上使用。

⑤ 图片与文本的区别

截图用于人阅读；自动提取的文本用于网站搜索，不代表通过了质量审计。特别是公式、表格和图片：文字模型不能仅凭图片路径理解其内容，不能把本站搜索索引直接视为已经清洗完成的 RAG 知识库。