跳转到主要内容

用于将Sphinx文档上传到PyPI的Setuptools命令

项目描述

此包包含一个setuptools命令,用于将Sphinx文档上传到Python包索引 (PyPI) 的专用URL packages.python.org。它是从Jannis Leidel的类似脚本派生出来的,该脚本自2009年以来未更新。

首页: https://github.com/WoLpH/sphinx-pypi-upload

upload_sphinx命令

upload_sphinx将从任意文档目录中创建必要的zip文件,并将其发布到正确的URL。

它也大致基于Sphinx自己的setuptools命令build_sphinx,该命令允许从命令行轻松构建文档。

upload_sphinx命令具有以下选项

  • --repository (-r):仓库URL [默认:http://pypi.python.org/pypi]

  • --show-response:显示来自服务器的完整响应文本

  • --upload-dir:上传目录

示例

假设有一个示例包,其中包含要上传到http://packages.python.org的Sphinx文档,结构如下

Example/
|-- example.py
|-- setup.cfg
|-- setup.py
|-- docs
|   |-- build
|   |   `-- html
|   |-- conf.py
|   |-- index.txt
|   `-- tips_tricks.txt

与任何其他基于setuptools的命令一样,您可以在Python包的setup.cfg中定义有用的默认值。以下代码片段展示了如何设置< span class="docutils literal"> build_sphinx 和 upload_sphinx setup.py命令的选项默认值。

[build_sphinx]
source-dir = docs/
build-dir  = docs/build
all_files  = 1

[upload_sphinx]
upload-dir = docs/build/html

要构建和上传Sphinx文档,您现在可以运行

$ python setup.py build_sphinx
$ python setup.py upload_sphinx

当然,您也可以直接将适当的选项传递给命令

$ python setup.py build_sphinx --source-dir=docs/ --build-dir=docs/build --all-files
$ python setup.y upload_sphinx --upload-dir=docs/build/html

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定选择哪一个,请了解更多关于安装包的信息。

源分布

Sphinx-PyPI-upload-2-0.2.2.tar.gz (4.4 kB 查看哈希值)

上传时间

支持