ReadTheDocs文档构建失败求助：RADIS参数错误与文件缺失

问题1：load()函数收到未预期的isotope关键字参数 #

• 核对本地开发环境与ReadTheDocs构建环境的RADIS版本一致性：如果你的脚本基于develop分支代码编写，但ReadTheDocs默认拉取稳定版，会出现参数不匹配。可在ReadTheDocs项目设置中，将构建依赖的RADIS指定为develop分支（比如在requirements.txt中添加git+https://github.com/radis/radis.git@develop）。
• 检查plot_compare_CO_geisa_hitran.py的load()调用代码：若isotope并非当前RADIS版本load()的合法参数，替换为正确实现逻辑。比如要筛选同位素，可在加载数据后用query()方法过滤，或参考RADIS对应分支的load()参数说明调整传参。

问题2：找不到测试文件trimmed_1857_VoigtCO_Minesi.mat #

• 修改MANIFEST.in文件，添加文件路径：假设文件位于docs/data目录，在MANIFEST.in中加入：

  include docs/data/trimmed_1857_VoigtCO_Minesi.mat
  

  确保路径与实际文件位置完全匹配。
• 检查项目.gitignore规则：确认该文件未被排除，否则ReadTheDocs拉取代码时无法获取到它。
• 若用setup.py或pyproject.toml管理包数据，可将该文件加入package_data配置，确保构建时正确包含。比如在setup.py中：

  setup(
      ...
      package_data={
          'radis.docs': ['data/trimmed_1857_VoigtCO_Minesi.mat'],
      },
      ...
  )
  

建议先本地用sphinx-build测试文档构建，提前排查问题，减少ReadTheDocs的反复构建测试。

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