OI Wiki印刷版制作教程：将竞赛知识库转为纸质资料的完整方法

你是否曾在备赛时苦于无法离线查阅OI Wiki的优质内容？是否希望将这份竞赛知识库浓缩成便于携带的纸质资料？本文将带你通过5个步骤，把开源项目OI Wiki的600+篇技术文档转化为专业印刷品，让算法学习不再受网络限制。

准备工作：环境配置与项目克隆

印刷版制作需要先搭建本地文档编译环境。确保系统已安装Python 3.8+和Git，然后执行以下命令获取完整项目：

git clone https://gitcode.com/GitHub_Trending/oi/OI-wiki
cd OI-wiki
pip install -r requirements.txt  # 安装mkdocs等依赖

核心配置文件mkdocs.yml定义了项目结构，其中第536-571行的主题设置和第604-640行的Markdown扩展配置，是确保文档正确渲染的关键。建议使用VS Code打开项目，其内置的Markdown预览功能可实时查看排版效果。

文档筛选：定制你的印刷内容

OI Wiki包含从基础算法到高级数据结构的完整知识体系（见目录结构），印刷前需根据需求筛选内容：

1. 精简导航：编辑mkdocs.yml的nav节点，保留需要印刷的章节。例如只保留算法基础、数据结构和数学板块
2. 移除交互元素：执行以下命令删除文档中的反馈系统脚本：

   sed -i '/OIWikiFeedbackSystem/d' mkdocs.yml
   

3. 图片优化：项目内置200+张教学图片，位于各章节的images目录下，如排序算法示意图和动态规划状态转移图

生成PDF：从网页到印刷格式的转换

使用mkdocs生成静态网站后，通过wkhtmltopdf工具批量转换为PDF：

mkdocs build  # 生成HTML文件到site/目录
wkhtmltopdf --enable-local-file-access \
            --outline-depth 3 \
            --page-size A4 \
            --margin-top 15mm \
            site/index.html oi-wiki-print.pdf

关键参数说明：

• --outline-depth 3：保留三级目录结构作为PDF书签
• --page-size A4：设置标准印刷尺寸
• --margin-*：调整页边距以适应装订需求

对于多章节文档，建议使用PDFsam进行合并和分页调整，确保目录与内容页编号对应。

排版优化：专业印刷的细节处理

为获得出版社级别的印刷效果，需要调整以下样式：

1. 自定义CSS：修改docs/_static/css/extra.css，添加印刷友好样式：

   @media print {
     .navbar, .footer, .feedback-button { display: none; }
     .content { width: 100%; margin: 0; padding: 0; }
     img { max-width: 100% !important; }
   }
   

2. 数学公式渲染：确保mathjax配置正确，避免公式溢出页边距。复杂公式建议使用LaTeX入门中的排版技巧。

3. 字体设置：在PDF转换时指定适合代码阅读的等宽字体：

   --footer-font-name "Fira Code" --header-font-name "思源宋体"
   

印刷指南：从数字文件到实体书

完成PDF制作后，有两种印刷方案可供选择：

方案	适用场景	成本估算	操作步骤
家用打印机	单份自用	￥50-100	1. 使用双面打印功能 2. 用打孔器装订 3. 添加封面保护
专业印刷服务	多份分享	￥1.5-3/页	1. 上传PDF到印刷平台 2. 选择胶装或骑马钉 3. 选用80g胶版纸

提示：印刷前务必打印样页检查，重点确认复杂图表和数学公式的清晰度。

扩展应用：打造个性化竞赛手册

进阶用户可通过以下方式定制专属印刷版：

1. 添加笔记空间：在CSS中为每章末尾添加空白页
2. 制作速查手册：提取常见算法模板单独成册
3. 整合习题集：将例题解析与理论内容穿插排版

项目的贡献指南鼓励用户分享改进方案，你可以将优化后的印刷配置提交PR，帮助更多竞赛选手受益。

通过以上步骤，即可将这个包含500+知识点、300+代码示例的竞赛知识库（项目描述）转化为便于离线学习的纸质资料。建议每季度更新一次印刷版，以同步OI Wiki的最新内容更新。

相关资源：mkdocs官方文档 | PDF优化指南 | 印刷术语对照表