pip 对 doc 目录中的文件有什么作用答案

【问题标题】：What does pip do with the files in doc directorypip 对 doc 目录中的文件有什么作用
【发布时间】：2014-04-08 15:09:32
【问题描述】：

我是新手。我从 pypi 下载了一个 Markdown tar.gz 文件。我使用 pip 安装：

root@machine:/home/user# pip install Markdown-2.4.tar.gz 
Unpacking ./Markdown-2.4.tar.gz
  Running setup.py (path:/tmp/pip-dV31I7-build/setup.py) egg_info for package from file:///home/irwan/Markdown-2.4.tar.gz

Installing collected packages: Markdown
  Running setup.py install for Markdown
    changing mode of build/scripts-2.7/markdown_py from 644 to 755
    Converting docs/release-2.1.1.txt -> build/docs/release-2.1.1.html
    Converting docs/index.txt -> build/docs/index.html
    Converting docs/release-2.1.0.txt -> build/docs/release-2.1.0.html
    Converting docs/release-2.0.2.txt -> build/docs/release-2.0.2.html
    Converting docs/reference.txt -> build/docs/reference.html
    Converting docs/release-2.0.txt -> build/docs/release-2.0.html
    Converting docs/cli.txt -> build/docs/cli.html
    Converting docs/test_suite.txt -> build/docs/test_suite.html
    Converting docs/siteindex.txt -> build/docs/siteindex.html
    Converting docs/release-2.3.txt -> build/docs/release-2.3.html
    Converting docs/change_log.txt -> build/docs/change_log.html
    Converting docs/release-2.0.1.txt -> build/docs/release-2.0.1.html
    Converting docs/release-2.2.0.txt -> build/docs/release-2.2.0.html
    Converting docs/authors.txt -> build/docs/authors.html

我在文件系统中找不到上述任何文本文件和 html 文件。任何人都知道 pip 将它们复制到哪里。

提前致谢

【问题讨论】：

看起来他们进入了构建目录。但是，它位于tmp ...（可能是/tmp/pip-dV31I7-build/build）的某个地方。当pip 退出时，它可能会被删除。

标签： python

【解决方案1】：

正如this answer 对类似问题所述，pip 不处理文档生成和安装。

但是，这个特定的包会在构建过程中生成文档。不知道有没有办法让pip不删除临时构建目录，但是可以很方便的手动构建一个包：

tar -xzf Markdown-2.4.tar.gz
cd Markdown-2.4/
python setup.py build

生成的文档按照构建报告的说明放置在build/docs/ 目录中。

【讨论】：