使用已安装的 pandas 而不是就地构建从源代码构建 pandas 文档答案

【问题标题】：build pandas documentation from source using installed pandas rather than an inplace build使用已安装的 pandas 而不是就地构建从源代码构建 pandas 文档
【发布时间】：2015-06-13 00:01:20
【问题描述】：

我的问题是：如何使用我最新的 pandas 安装来构建 pandas 文档？

我阅读了 pandas/doc/README.rst，它说导航到 pandas/doc 目录并运行 python make.py html。不幸的是，这对我不起作用，因为它似乎需要首先完成熊猫的就地构建。我的（Windows）计算机没有进行开发构建的必要先决条件，当我只想添加一些改进文档的注释时，这似乎是一个不必要的负担。

我问这个问题的背景是本周早些时候我发布了一个SO question 关于pandas hdf5 输出。在 discussing the answer 和 Jeff 中，他鼓励我在文档中添加一些评论。所以我分叉了 pandas 存储库，并开始考虑如何添加到文档中。我对设置完整熊猫安装的开发版本不感兴趣。我希望能够在提交拉取请求之前修改文档、构建文档并查看我的更改。有没有合理的方法来做到这一点？

谢谢！

【问题讨论】：

这不应该是您在github 上发布的内容而不是 SO 吗？
我有时不确定在哪里发布什么。我认为这是一个关于如何为熊猫文档做出贡献的一般熊猫问题，所以它应该继续下去。现在我已经看到这是一个错误（或未记录的功能——请参阅下面的评论），我做了一个issue on github。

标签： pandas python-sphinx

【解决方案1】：

Here 是 pandas 贡献指南和操作指南。

【讨论】：

我已经看到了。我发现我遇到的问题是make.py 脚本有os.environ['PYTHONPATH'] = '..' 语句，这似乎迫使python 从源代码树中获取pandas。我注释掉了那行，现在我遇到的python make.py html 错误似乎已经消失，并且生成了 html 文档。我将继续努力，将我的 2 美分添加到文档中。