无法生成MongoDB HTML格式手册的解决方案咨询

最佳解决路径 #

1. 提前在有网环境完成构建（最推荐） #

因为目标电脑无网，没必要在无网机器上折腾构建流程，直接在同架构的有网电脑上做好准备再转移：

• 搭建Python 2.7虚拟环境（mongodb/docs旧构建链基于Python2）
• 安装适配Python2.7的旧版giza（比如v0.4.15），同时用pip download把所有依赖包下载到本地：

  # 创建并激活虚拟环境
  virtualenv -p python2.7 mongo-docs-env
  source mongo-docs-env/bin/activate
  # 安装指定版本giza
  pip install giza==0.4.15
  # 下载所有依赖到本地目录
  pip download -d ./mongo-docs-deps -r <(pip freeze)
  

• 直接在有网环境执行make html完成HTML手册构建，把生成的_build/html目录打包，复制到无网电脑就能直接使用。

2. 必须在无网机器上构建的操作步骤 #

如果一定要在无网机器上做构建：

• 把有网环境下载好的依赖包目录（mongo-docs-deps）和mongodb/docs源码包转移到无网机器
• 在无网机器上创建Python2.7虚拟环境，从本地目录安装所有依赖：

  virtualenv -p python2.7 mongo-docs-env
  source mongo-docs-env/bin/activate
  # 从本地依赖包安装giza及所有依赖
  pip install --no-index --find-links=./mongo-docs-deps giza==0.4.15
  

• 进入mongodb/docs源码目录，执行make html完成构建。

Python2.7安装旧版本giza能否解决依赖问题？ #

完全可以。giza v0.4.x系列是专为Python2.7设计的稳定版本，对Pygments的依赖要求在>=2.0,<2.11区间，这个范围的Pygments版本完全支持Python2.7，不会出现依赖冲突。你之前用的v0.5.18是giza的过渡版本，已经开始适配Python3，同时保留了部分Python2.7兼容，但依赖要求升级到了不支持Python2.7的Pygments版本，所以才会触发报错。

内容的提问来源于stack exchange，提问作者user3830744