# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-Sphinx
VERSION=		3.2.0
KEYWORDS=		python
VARIANTS=		py38 py37
SDESC[py37]=		Python documentation generator (PY37)
SDESC[py38]=		Python documentation generator (PY38)
HOMEPAGE=		http://sphinx-doc.org/
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPI/S/Sphinx
DISTFILE[1]=		Sphinx-3.2.0.tar.gz:main
DF_INDEX=		1
SPKGS[py37]=		single
SPKGS[py38]=		single

OPTIONS_AVAILABLE=	PY38 PY37
OPTIONS_STANDARD=	none
VOPTS[py37]=		PY38=OFF PY37=ON
VOPTS[py38]=		PY38=ON PY37=OFF

BUILD_DEPENDS=		tar:primary:standard

DISTNAME=		Sphinx-3.2.0
EXTRACT_HEAD[1]=	{{LOCALBASE}}/bin/gtar -xf
EXTRACT_TAIL[1]=	--no-same-owner --no-same-permissions

GENERATED=		yes

[PY37].BUILDRUN_DEPENDS_ON=		python-sphinxcontrib-applehelp:single:py37
					python-sphinxcontrib-devhelp:single:py37
					python-sphinxcontrib-jsmath:single:py37
					python-sphinxcontrib-htmlhelp:single:py37
					python-sphinxcontrib-serializinghtml:single:py37
					python-sphinxcontrib-qthelp:single:py37
					python-Jinja2:single:py37
					python-Pygments:single:py37
					python-docutils:single:py37
					python-snowballstemmer:single:py37
					python-Babel:single:py37
					python-alabaster:single:py37
					python-imagesize:single:py37
					python-requests:single:py37
					python-setuptools:single:py37
					python-packaging:single:py37
[PY37].USES_ON=				python:py37

[PY38].BUILDRUN_DEPENDS_ON=		python-sphinxcontrib-applehelp:single:py38
					python-sphinxcontrib-devhelp:single:py38
					python-sphinxcontrib-jsmath:single:py38
					python-sphinxcontrib-htmlhelp:single:py38
					python-sphinxcontrib-serializinghtml:single:py38
					python-sphinxcontrib-qthelp:single:py38
					python-Jinja2:single:py38
					python-Pygments:single:py38
					python-docutils:single:py38
					python-snowballstemmer:single:py38
					python-Babel:single:py38
					python-alabaster:single:py38
					python-imagesize:single:py38
					python-requests:single:py38
					python-setuptools:single:py38
					python-packaging:single:py38
[PY38].USES_ON=				python:py38

[FILE:2766:descriptions/desc.single]
========
 Sphinx
========

   :alt: Package on PyPI

   :alt: Documentation Status

   :alt: Build Status (Travis CI)

   :alt: Build Status (AppVeyor)

   :alt: Build Status (CircleCI)

   :alt: Code Coverage Status (Codecov)

   :alt: BSD 3 Clause

   :alt: Open Source Helpers badge

Sphinx is a tool that makes it easy to create intelligent and beautiful
documentation for Python projects (or other documents consisting of
multiple
reStructuredText sources), written by Georg Brandl.  It was originally
created
for the new Python documentation, and has excellent facilities for Python
project documentation, but C/C++ is supported as well, and more languages
are
planned.

Sphinx uses reStructuredText as its markup language, and many of its
strengths
come from the power and straightforwardness of reStructuredText and its
parsing
and translating suite, the Docutils.

Among its features are the following:

* Output formats: HTML (including derivative formats such as HTML Help,
Epub
  and Qt Help), plain text, manual pages and LaTeX or direct PDF output
  using rst2pdf
* Extensive cross-references: semantic markup and automatic links
  for functions, classes, glossary terms and similar pieces of information
* Hierarchical structure: easy definition of a document tree, with
automatic
  links to siblings, parents and children
* Automatic indices: general index as well as a module index
* Code handling: automatic highlighting using the Pygments highlighter
* Flexible HTML output using the Jinja 2 templating engine
* Various extensions are available, e.g. for automatic testing of snippets
  and inclusion of appropriately formatted docstrings
* Setuptools integration

For more information, refer to the `the documentation`__.

.. __: http://www.sphinx-doc.org/

Installation
============

Sphinx is published on `PyPI`__ and can be installed from there::

   pip install -U sphinx

We also publish beta releases::

   pip install -U --pre sphinx

If you wish to install `Sphinx` for development purposes, refer to `the
contributors guide`__.

__ https://pypi.org/project/Sphinx/
__ http://www.sphinx-doc.org/en/master/internals/contributing.html

Documentation
=============

Documentation is available from `sphinx-doc.org`__.

__ http://www.sphinx-doc.org/

Get in touch
============

- Report bugs, suggest features or view the source code `on GitHub`_.
- For less well defined questions or ideas, use the `mailing list`_.

.. _on GitHub: https://github.com/sphinx-doc/sphinx
.. _mailing list: https://groups.google.com/forum/#!forum/sphinx-users

Please adhere to our `code of conduct`__.

__ http://www.sphinx-doc.org/en/master/code_of_conduct.html

Testing
=======

Continuous testing is provided by `Travis`__ (for unit tests and style
checks


[FILE:98:distinfo]
cf2d5bc3c6c930ab0a1fbef3ad8a82994b1bf4ae923f8098a05c7e5516f07177      5970521 Sphinx-3.2.0.tar.gz