如何通过终端安装Docutils以使Django admindocs正常工作？

Question

Docutils是一个非常好的软件包。如果你正在使用Django，admindocs软件包需要docutils。有关使用Web浏览器安装的说明可用，但如果您远程通过SSH登录终端怎么办？在这种情况下如何安装？如果您只想要一个快速的终端命令来完成此工作，该怎么办呢？

- kd4ttc

Answer 1

我知道我来晚了，但被接受的答案并不完全反映Python社区成员的常见最佳实践(甚至更少地反映了Django社区成员的观点)。虽然所述的手动安装过程确实有效，但比起以下方法，它要繁琐得多且容易出错：

你应该使用Pip。 使用Pip在系统范围内安装docutils就像这样简单：

$ sudo pip install docutils

这不仅适用于docutils，还适用于几乎所有在'Cheese Shop'（以及许多其他代码存储库，如Github、Bitbucket等）上的包。

您可能还想了解其他常见的Python最佳实践工具，如virtualenv和virtualenvwrapper，以避免全局软件包安装。

要在Ubuntu/Debain上安装Pip，我通常会执行以下操作：

$ sudo apt-get install python-pip

顺便说一句：对于virtualenv，使用'sudo apt-get install python-virtualenv'，对于virtualenvwrapper，使用'sudo apt-get install virtualenvwrapper'。

- Beau

---

非常感谢您在Python和Django开发中解释了明智的惯例。我正在运行OS X Server 10.6.8。随着升级到2.7，Python已经有所改变。我注意到各种文件夹位置没有被提及，这些在网上的优秀教程里都找不到。但是，由于PIP是标准的，我会开始使用它，并根据需要移动或建立符号链接目录。为您优美的回复点赞！ - kd4ttc

Answer 2

安装的关键是使用curl实用程序。以下是安装docutils的命令：

mkdir docutilsetup
cd docutilsetup
curl -o docutils-docutils.tar.gz http://docutils.svn.sourceforge.net/viewvc/docutils/trunk/docutils/?view=tar
gunzip docutils-docutils.tar.gz 
tar -xf docutils-docutils.tar 
cd docutils
sudo python setup.py install

这将执行以下步骤：创建一个目录来下载docutils。进入刚刚创建的目录，使用curl下载docutils的压缩版本。解压文件，这将创建一个子目录docutils。进入该目录并使用root权限安装。

如果您正在使用Django，则必须重新启动Django才能使admindocs开始工作。

- kd4ttc

---

尽管这种方法可以工作，但是Beau更明智的使用pip更加干净和快速，并且比这种方法更贴近Python和Django的惯例。 - Llanilek

Answer 3

虽然这是一个旧的线程，但我想分享我找到的答案。要安装，请键入命令

sudo apt install python-docutils

或者

sudo apt install python3-docutils

这将安装所需的依赖项。昨天，我使用这个命令为Geany编辑器安装了docutils，并且它工作得很好。

- Sadaananth Anbucheliyan