零网络 OI Wiki 离线部署的 3 条路径——完整指南【免费下载链接】OI-wiki:star2: Wiki of OI / ICPC for everyone. 某大型游戏线上攻略内含炫酷算术魔法项目地址: https://gitcode.com/GitHub_Trending/oi/OI-wiki赛场断网、飞行途中无信号、封闭机房无法外联——OI Wiki 离线版能让这些场景下的算法学习不断档。三条离线部署路径摆在这里按机器现状选一条从 30 秒到半小时随时把整套离线算法资料装进本地。 10 秒选路三列速览表路径前置依赖大致耗时适合人群可否自定义A · Docker 容器仅 Docker30 秒3 分钟新手、多平台用户否B · 源码本地构建Python 3 uv git530 分钟开发者、需自定义构建是C · gh-pages 静态页仅 git Python约 1 分钟临时离线查阅否 路径 ADocker 拉镜像3 分钟起一个本地 OI Wiki判断——先看机器是否具备 Docker 环境docker -v # 有版本号即可用没有则先按 Docker 官方文档安装执行——镜像源任选其一拉取后直接后台启动并映射端口docker pull 24oi/oi-wiki # 官方镜像仓库 docker pull daocloud.io/sirius/oi-wiki # 国内 DaoCloud 仓库 docker run -d -p 8080:8000 --name oi-wiki 24oi/oi-wiki-d让容器在后台常驻-p 8080:8000把容器内 8000 端口映射到主机的 8080。验证——浏览器打开http://127.0.0.1:8080能看到 OI Wiki 首页即部署成功。容器随时可用docker stop oi-wiki/docker start oi-wiki停启更细的构建参数说明见 Docker 部署官方文档。⚙️ 路径 B源码构建静态页面——与路径 A 的 4 处差异仓库获取同路径 A 的思路但此处克隆的是完整源码而非镜像git clone https://gitcode.com/GitHub_Trending/oi/OI-wiki.git --depth1 cd OI-wiki差异一依赖安装换成 Python 生态国内源可避免超时pip install uv uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple/差异二需额外安装自定义主题./scripts/pre-build/install-theme.sh # Windows 下改用 Git Bash 执行差异三构建产物落在site目录而不是跑一个常驻容器uv run mkdocs build -v差异四预览方式从访问端口变为起一个静态服务器cd site python -m http.server 8000本地访问验证同路径 A打开http://127.0.0.1:8000即可。选这条路还能改构建配置、控制 MathJax 渲染完整步骤见 README 的离线版章节。 路径 C一条命令克隆 gh-pages临时离线查阅不想装任何依赖、只用一两次时最轻量——已构建好的静态页面都在gh-pages分支里git clone https://gitcode.com/GitHub_Trending/oi/OI-wiki -b gh-pages cd OI-wiki python -m http.server 8000⏱️ 内容保鲜路径 × 更新命令对照表离线版会滞后于上游内容建议定期刷新路径更新操作A · Dockerdocker exec -it oi-wiki /bin/bash进入后执行wiki-upd或停删容器、重新docker pull再启动B · 源码git pull拉新代码再uv run mkdocs build -v重建C · gh-pagesgit pull拉取最新静态页即可无需重建 故障速查现象、原因、修复命令现象原因修复命令依赖安装超时失败海外 PyPI 源访问慢uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple/8000 端口连不上端口被其他进程占用python -m http.server 8080换端口访问docker 提示权限不足当前用户不在 docker 组sudo usermod -aG docker $USER注销后重新登录页面样式或公式残缺主题 / MathJax 资源下载不全重跑./scripts/pre-build/install-theme.sh新手直接走 Docker要改构建参数才选源码临时用一次选 gh-pages。使用问题与改进建议可提交到项目 issue 区也欢迎参与贡献 OI Wiki 离线版。【免费下载链接】OI-wiki:star2: Wiki of OI / ICPC for everyone. 某大型游戏线上攻略内含炫酷算术魔法项目地址: https://gitcode.com/GitHub_Trending/oi/OI-wiki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
