狮身人面像快速入门不起作用答案

【问题标题】：Sphinx-quickstart doesn't work狮身人面像快速入门不起作用
【发布时间】：2014-11-11 23:25:37
【问题描述】：

我正在尝试在远程机器上安装 sphinx。

由于我没有访问根目录的权限，所以我这样做了：

$bash

$mkdir -p ~/local/lib/python2.7/site-packages

$export PYTHONPATH=$PYTHONPATH:~/local/lib/python2.7/site-packages

$export PATH=$PATH::~/local/lib/python2.7/site-packages

$easy_install -U --prefix=$HOME/local Sphinx

但显然，$easy_install 没有构建 sphinx-quickstart；当我输入

$sphinx-quickstart

我收到以下消息：

bash: sphinx-quickstart: command not found

我试过了

find $HOME -name sphinx-quickstart

没有找到结果。但是，我可以在 python 中导入 sphinx：

$python

然后

>>import sphinx

有效。知道为什么 sphinx-quickstart 不起作用吗？

【问题讨论】：

PATH 变量是否包含找到sphinx-quickstart 的子目录？ -- 我看到你已经更新了你的PYTHONPATH 变量，但是你是否以同样的方式更新了你的PATH 变量？
不，我没有。但现在我做到了，还是一样。我输入了 setenv PATH $PATH\:home/local/lib/python2.7/site-packages
$export export: Command not found.
我还输入了$bash，然后输入了bash-4.3$ export PATH=$PATH:~/local/lib/python2.7/site-packages 这有效，但不能解决sphinx-quickstart 的问题
试试locate sphinx-quickstart和find $HOME -name sphinx-quickstart。

标签： bash installation root local python-sphinx

【解决方案1】：

调用sphinx-quickstart 的另一种方法是显式加载Sphinx 的快速启动模块。对于 Sphinx v1.7+：

python -m sphinx.cmd.quickstart

对于旧版本的 Sphinx：

python -m sphinx.quickstart

例如：

$ /c/Python35/python -m sphinx.quickstart
Welcome to the Sphinx 1.6.2 quickstart utility.
...

【讨论】：

这会在 Windows 上产生No module named sphinx.quickstart。
@DiddiZ，在较新版本的 Sphinx 上可能是 python -m sphinx.cmd.quickstart。

【解决方案2】：

我在这个网页上找到了解决方案：

User (root/sudo free) installation of Python modules.

在 3 节中。 Python 2.6+他提到命令行命令在

~/local/bin

虽然我已将~/local/lib/python2.7/siste-packages 放在路径中，但~/local/bin 目录不在路径中。所以我所做的一切

$export PYTHONPATH=$PYTHONPATH:~/local/bin

现在它可以工作了。

不知道为什么find $HOME -name sphinx-quickstart没有找到sphinx-quickstart

【讨论】：

显然easy_install会自动创建bin目录

【解决方案3】：

在 MacOS (Catalina) 和 zsh 中：

我用 brew 安装了 sphinx，遇到了和你一样的问题。

解决方案：使用 conda 将其安装为 conda install sphinx，现在它适用于我

$ sphinx-quickstart
Welcome to the Sphinx 2.3.0 quickstart utility.

Installation Guide

【讨论】：

【解决方案4】：

注意，如果您在虚拟环境中使用诗歌来运行

poetry run py -m sphinx.cmd.quickstart

py 是 Windows 的 python 启动器。

【讨论】：