GitHub用户反馈
让大型形式化证明在浏览器中直接阅读：读者要求用 GitHub Pages 托管 HTML 目录
一位想阅读费马大定理 Lean 4 形式化证明的读者指出，仓库把 HTML 静态浏览版放在仓库里，必须克隆整个仓库才能打开；他建议用 GitHub Pages 托管 html 目录（可能需重命名为 docs），让读者直接在浏览器查看。仓库本身声明不再维护、不接受贡献。
查看原始信号github:anthropics/fermats-last-theorem
目标用户
想浏览大型 Lean 4 形式化证明（如费马大定理）的数学、逻辑与计算机科学学习者与研究者，以及 Lean 社区成员。
潜在需求
让读者无需克隆整个仓库，就能在浏览器里直接打开这个大型形式化证明的 HTML 页面；具体行为是把 html/ 目录发布为 GitHub Pages 静态站点。
发生场景
该仓库提供了一个约 390 MB 的 html/ 目录，作为完整离线浏览站点；读者需要先克隆或下载整个仓库，再在本地打开 html/index.html。一位用户认为门槛太高，直接建议用 GitHub Pages 托管该目录，并提示可能需要把 html 重命名为 docs。
来源证据
一位用户建议把仓库中的 html/ 目录通过 GitHub Pages 托管（可能需重命名为 docs），理由是读者不应为了阅读而克隆整个仓库。
Host static site with github pages You should just host the html dir as a static site with github pages instead of making people clone the repo. It should be a simple settings change in the Github repo settings: https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-from-a-branch Edit: you may need to rename the "html" dir to "docs", the settings only accept that or the root as valid pathshttps://github.com/anthropics/fermats-last-theorem/issues/1
为什么值得留意
这条 issue 把“证明已完成、可机器验证”和“读者能否方便读到”之间的落差直接暴露出来：文档虽已渲染成静态 HTML，分发仍要克隆仓库；而仓库明确不再维护，该请求很可能无人处理。修复路径只是静态托管和目录改名，成本极低，适合独立开发者作为小型切入点验证。
已有方案
- 克隆或下载整个仓库后在本地打开 html/index.html（离线浏览）
未满足部分
- HTML 浏览版的唯一获取方式是克隆/下载整个仓库，没有可直接访问的在线 URL
- 仓库声明不再维护且不接受贡献，README 未提供任何在线浏览入口
可能延伸 · 模型推测
- 将大型 Lean/Mathlib 文档的生成与静态托管做成通用工具（推测）
- 为大型文档仓库提供一键启用 GitHub Pages 的辅助脚本或 CI 步骤（推测）
- 为不再维护的开源文档项目提供镜像托管或存档阅读服务（推测）
- 把 PROOF-PATH 式证明路线做成交互式在线阅读器（推测）
目前未知
- 该 issue 作者是否代表多数读者，以及有多少人因克隆仓库而放弃阅读（目前只有单条报告）
- html/ 目录重命名为 docs 后是否完全兼容 GitHub Pages（issue 作者也只是提示可能）
- 仓库作者是否已在仓库外（如个人网站）提供在线版本
- 该需求是否只适用于此项目，还是其他大型形式化证明项目也有类似问题
继续核实
- 除该 issue 外，是否还有其他读者或项目表达过对大型形式化证明在线浏览的类似需求？
- Lean 社区中大型形式化项目通常如何发布可读文档（本地浏览、GitHub Pages、文档站）？
- 该 html/ 目录发布为静态站点后，实际访问量和使用场景是否成立？
主题词
formal proof browsingmachine-checked prooflarge repository accessstatic site hosting