安装Sphinx

概述

狮身人面像是用 `Python`__ 并支持Python3.9+。它建立在许多第三方库的肩膀上,例如 `Docutils`__`Jinja`_ _,它们在安装Sphinx时安装。

Linux

Debian/Ubuntu

安装以下任一 python3-sphinx 使用 apt-get

$ apt-get install python3-sphinx

如果它还不存在,这将为您安装Python。

Rhel,CentOS

安装 python-sphinx 使用 yum

$ yum install python-sphinx

如果它还不存在,这将为您安装Python。

其他发行版本

大多数Linux发行版的包存储库中都有Sphinx。通常,该包被称为 python3-sphinxpython-sphinxsphinx 。请注意,至少还有另外两个包含 sphinx 以他们的名字命名的:语音识别工具包( CMU Sphinx )和全文搜索数据库( Sphinx search )。

MacOS

可以使用以下命令安装Sphinx `Homebrew`__, `MacPorts`__, or as part of a Python distribution such as `Anaconda`__.

自制酒

$ brew install sphinx-doc

有关更多信息,请参阅 `package overview`__.

MacPorts

安装以下任一 python3x-sphinx 使用 port

$ sudo port install py39-sphinx

若要设置可执行文件路径,请使用 port select 命令:

$ sudo port select --set python python39
$ sudo port select --set sphinx py39-sphinx

有关更多信息,请参阅 `package overview`__.

响尾蛇

$ conda install sphinx

窗口

可以使用以下工具安装Sphinx `Chocolatey`__installed manually

巧克力味

$ choco install sphinx

您将需要 install Chocolatey 在运行这个程序之前。

有关更多信息,请参阅 `chocolatey page`__.

其他方法

Most Windows users do not have Python installed by default, so we begin with the installation of Python itself. To check if you already have Python installed, open the Command Prompt (⊞Win-r and type cmd). Once the command prompt is open, type python --version and press Enter. If Python is installed, you will see the version of Python printed to the screen. If you do not have Python installed, refer to the `Hitchhikers Guide to Python's`__ Python on Windows installation guides. You must install `Python 3`__.

安装了Python后,您可以使用以下命令安装Sphinx pip 。请参阅 pip installation instructions 有关更多信息,请点击下面的链接。

从PYPI安装

Sphinx包发布在 Python Package Index 。从安装程序包的首选工具 PyPIpip 。此工具随所有现代版本的Python一起提供。

在Linux或MacOS上,您应该打开您的终端并运行以下命令。

$ pip install -U sphinx

On Windows, you should open Command Prompt (⊞Win-r and type cmd) and run the same command.

C:\> pip install -U sphinx

安装后,键入 sphinx-build --version 在命令提示符下。如果一切正常,您将看到刚刚安装的Sphinx包的版本号。

安装自 PyPI 还允许您安装最新的开发版本。您通常不需要(或不想)这样做,但如果您在最新的稳定版本中看到可能的错误,它可能会很有用。为此,请使用 --pre 旗帜。

$ pip install -U --pre sphinx

使用虚拟环境

使用pip安装Sphinx时,强烈建议使用 virtual environments ,它将已安装的程序包与系统程序包隔离,从而消除了使用管理员权限的需要。在中创建虚拟环境 .venv 目录中,使用以下命令。

$ python -m venv .venv

有关它们的更多信息,请参阅 Python Packaging User Guide

警告

请注意,在某些Linux发行版中,例如Debian和Ubuntu,这可能需要如下所示的额外安装步骤。

$ apt-get install python3-venv

多克尔

有关狮身人面像的Docker图像发布在 Docker Hub 。有两种图像:

前者用于Sphinx的标准用法,后者主要用于使用LaTeX的PDF构建。请根据您的目的选择一个。

备注

Sphinxdoc/sphinx-latexpdf包含TeXLive包。所以图像非常大(超过2 GB!)。

提示

当使用停靠器图像时,请使用 docker run 命令来调用狮身人面像命令。例如,您可以使用以下命令创建一个Sphinx项目:

$ docker run -it --rm -v /path/to/document:/docs sphinxdoc/sphinx sphinx-quickstart

您可以使用以下命令构建HTML文档:

$ docker run --rm -v /path/to/document:/docs sphinxdoc/sphinx make html

有关更多详细信息,请阅读 `README file`__ 码头的图像。

从源安装

您可以直接从 `Git repository`__. 这可以通过克隆Repo并从本地克隆安装来完成,只需通过直接安装即可 git

$ git clone https://github.com/sphinx-doc/sphinx
$ cd sphinx
$ pip install .
$ pip install git+https://github.com/sphinx-doc/sphinx

您也可以在以下位置下载Git回购的快照 `tar.gz`__`zip`__ 格式化。下载并解压缩后,即可与一起安装 pip 如上段所述。