OI Wiki离线版使用教程：无网络环境下的竞赛知识学习方案
项目地址: https://gitcode.com/GitHub_Trending/oi/OI-wiki 你是否遇到过网络不稳定却急需查阅算法资料的情况？是否想在没有网络的环境下继续学习编程竞赛知识？本文将详细介绍三种OI Wiki离线版部署方案，帮助你在任何场景下都能高效学习竞赛知识。读完本文后，你将掌握Docker容器部署、本地源码构建和静态页面直接访问三种离线学习方法，轻松应对无网络环境下的学习需求。
方案一：Docker容器部署（推荐新手）
环境准备
Docker部署方式具有跨平台、配置简单的特点，适合大多数用户。首先需要确保你的系统中已安装Docker环境。如果尚未安装，可以参考Docker官方文档进行安装。
获取OI Wiki镜像
OI Wiki提供了多个镜像源，你可以根据自己的网络环境选择合适的镜像源拉取镜像：
# 镜像仓库（官方镜像仓库）
docker pull 24oi/oi-wiki
# 国内镜像仓库
docker pull daocloud.io/sirius/oi-wiki
# 国内镜像仓库
docker pull ccr.ccs.tencentyun.com/oi-wiki/oi-wiki
运行容器
拉取镜像后，使用以下命令运行容器：
# 将容器的8000端口映射到主机的8080端口
docker run -d -p 8080:8000 --name oi-wiki 24oi/oi-wiki
其中，-d参数表示后台运行容器，-p 8080:8000表示将容器的8000端口映射到主机的8080端口，--name oi-wiki为容器指定一个名称，方便后续操作。
访问离线版OI Wiki
容器启动后，打开浏览器，访问http://127.0.0.1:8080即可使用离线版OI Wiki。
容器常用操作
OI Wiki容器提供了一些实用的命令，方便你对Wiki内容进行更新和管理：
# 进入容器
docker exec -it oi-wiki /bin/bash
# 在容器内更新Wiki内容
wiki-upd
# 构建静态页面
wiki-bld
# 退出容器
exit
# 停止容器
docker stop oi-wiki
# 启动容器
docker start oi-wiki
更多关于Docker部署的详细信息，可以参考官方文档：docs/intro/docker-deploy.md
方案二：本地源码构建（适合开发者）
环境要求
本地源码构建需要安装Python3和uv包管理工具。如果你使用的是Linux或macOS系统，Python3通常已经预装。Windows用户可以从Python官网下载安装包进行安装。
获取源码
使用以下命令克隆OI Wiki仓库：
git clone https://gitcode.com/GitHub_Trending/oi/OI-wiki.git --depth=1
cd OI-wiki
安装依赖
安装uv包管理工具并同步项目依赖：
# 安装uv
pip install uv
# 使用清华源安装依赖
uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple/
安装自定义主题
OI Wiki使用了自定义主题，需要单独安装：
# Linux/macOS用户
./scripts/pre-build/install-theme.sh
# Windows用户（需使用Git Bash执行）
bash scripts/pre-build/install-theme.sh
构建静态页面
执行以下命令构建静态页面，生成的文件将保存在site目录下：
uv run mkdocs build -v
本地预览
构建完成后，你可以使用Python内置的HTTP服务器来预览生成的静态页面：
# 进入site目录
cd site
# 启动HTTP服务器
python -m http.server 8000
然后在浏览器中访问http://127.0.0.1:8000即可查看离线版OI Wiki。
方案三：直接获取静态页面（最快速方案）
如果你只需要快速获取最新的静态页面，而不需要进行本地构建，可以直接克隆项目的gh-pages分支，该分支包含了已经构建好的静态页面：
git clone https://gitcode.com/GitHub_Trending/oi/OI-wiki.git -b gh-pages
克隆完成后，进入项目目录，启动HTTP服务器即可：
cd OI-wiki
python -m http.server 8000
这种方法的优点是获取速度快，不需要安装额外的依赖，适合临时需要离线访问的场景。
离线版内容更新
为了确保你能获取到最新的内容，建议定期更新离线版OI Wiki。根据你选择的部署方案，可以使用以下方法进行更新：
Docker部署更新
# 停止并删除现有容器
docker stop oi-wiki
docker rm oi-wiki
# 拉取最新镜像
docker pull 24oi/oi-wiki
# 重新运行容器
docker run -d -p 8080:8000 --name oi-wiki 24oi/oi-wiki
源码部署更新
# 进入项目目录
cd OI-wiki
# 拉取最新代码
git pull
# 重新构建
uv run mkdocs build -v
静态页面更新
# 进入项目目录
cd OI-wiki
# 拉取最新代码
git pull
常见问题解决
构建过程中依赖安装失败
如果在安装依赖时遇到网络问题，可以尝试更换国内源：
uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple/
启动服务器后无法访问
如果启动HTTP服务器后无法访问，可能是端口被占用，可以尝试更换端口：
python -m http.server 8080
然后访问http://127.0.0.1:8080。
Docker命令需要管理员权限
如果执行Docker命令时提示权限不足，可以将当前用户添加到docker组：
sudo usermod -aG docker $USER
然后注销并重新登录即可。
总结
本文介绍了三种OI Wiki离线版部署方案，各有优缺点：
- Docker部署：配置简单，跨平台支持好，适合大多数用户
- 源码构建：可以自定义构建选项，适合有开发经验的用户
- 静态页面：获取速度快，适合临时需要离线访问的场景
无论你是在没有网络的环境下学习，还是希望提高访问速度，都可以根据自己的需求选择合适的方案。希望本文能帮助你更好地利用OI Wiki进行编程竞赛学习！
如果你在使用过程中遇到其他问题，可以查阅官方文档或在GitHub上提交issue寻求帮助。同时，也欢迎你为OI Wiki项目贡献自己的力量，一起完善这个优秀的编程竞赛知识库。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
