sphinxcontrib-cheeseshop is a Sphinx extension that adds directives for easy linking to Cheese Shop (Python Package Index) packages. It requires Sphinx 1.0.
It's a bit runny, sir...
It supports a directive and a role, as well as a new config value.
Well, as a matter of fact it's very runny, sir...
The pypi-release directive adds an HTML-only output block that automatically fetches the download links for the latest release of the given package and displays them as a list. For example,
.. pypi-release:: Sphinx
:prefix: Download
:class: sidebar
will display "Download:" and a list of download links (eggs and the source distribution) for the latest Sphinx release. The "sidebar" class makes the resulting appear like a reStructuredText sidebar. Using "prefix", you can select what text precedes the list.
I think it's runnier than you like it, sir...
The pypi role links to a package. Use it in one of these forms:
:pypi:`Sphinx` -- link to latest release
:pypi:`the Sphinx package < Sphinx >` -- dito, but explicit title given
:pypi:`Sphinx (0.6)` -- link to specific release
:pypi:`the Sphinx package < Sphinx (0.6) >` -- dito, with explicit title
This extension also adds a cheeseshop_url config value, which defaults to 'http://pypi.python.org/pypi' and is used to build URLs to the Cheese Shop.
Requirements:
· Python
· Sphinx
