Read the Docs Sphinx Extensions
===============================
.. image:: https://img.shields.io/pypi/v/readthedocs-sphinx-ext.svg
:target: https://pypi.python.org/pypi/readthedocs-sphinx-ext
:alt: PyPI Version
.. image:: https://circleci.com/gh/readthedocs/readthedocs-sphinx-ext.svg?style=svg
:target: https://circleci.com/gh/readthedocs/readthedocs-sphinx-ext
:alt: Build Status
This module adds extensions that make Sphinx easier to use.
Some of them require Read the Docs features,
others are just code that we ship and enable during builds on Read the Docs.
We currently ship:
* An extension for building docs like Read the Docs
* ``template-meta`` - Allows users to specify template overrides in per-page context.
Releasing
---------
#. Increment the version in ``setup.py``
#. Tag the release in git: ``git tag $NEW_VERSION``.
#. Push the tag to GitHub: ``git push --tags origin main``
#. Upload the package to PyPI:
.. code:: bash
$ python -m pip install --upgrade pip build twine
$ rm -rf dist/
$ python -m build --sdist --wheel
$ twine upload --username=__token__ --password=$PYPI_TOKEN dist/*
Raw data
{
"_id": null,
"home_page": "http://github.com/readthedocs/readthedocs-sphinx-ext",
"name": "readthedocs-sphinx-ext",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Read the Docs, Inc",
"author_email": "dev@readthedocs.com",
"download_url": "https://files.pythonhosted.org/packages/32/a1/17f5d630decdd36433116a5a516488554773933a4ed9b3c9580b53be4a78/readthedocs-sphinx-ext-2.2.4.tar.gz",
"platform": null,
"description": "Read the Docs Sphinx Extensions\n===============================\n\n.. image:: https://img.shields.io/pypi/v/readthedocs-sphinx-ext.svg\n :target: https://pypi.python.org/pypi/readthedocs-sphinx-ext\n :alt: PyPI Version\n.. image:: https://circleci.com/gh/readthedocs/readthedocs-sphinx-ext.svg?style=svg\n :target: https://circleci.com/gh/readthedocs/readthedocs-sphinx-ext\n :alt: Build Status\n\nThis module adds extensions that make Sphinx easier to use.\nSome of them require Read the Docs features,\nothers are just code that we ship and enable during builds on Read the Docs.\n\nWe currently ship:\n\n* An extension for building docs like Read the Docs\n* ``template-meta`` - Allows users to specify template overrides in per-page context.\n\n\nReleasing\n---------\n\n#. Increment the version in ``setup.py``\n#. Tag the release in git: ``git tag $NEW_VERSION``.\n#. Push the tag to GitHub: ``git push --tags origin main``\n#. Upload the package to PyPI:\n\n .. code:: bash\n\n $ python -m pip install --upgrade pip build twine\n $ rm -rf dist/\n $ python -m build --sdist --wheel\n $ twine upload --username=__token__ --password=$PYPI_TOKEN dist/*\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Sphinx extension for Read the Docs overrides",
"version": "2.2.4",
"project_urls": {
"Homepage": "http://github.com/readthedocs/readthedocs-sphinx-ext"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1245c0db0a248a10395a6d8d3cacff3a50279b62f0fe165c2b23341c43db7d18",
"md5": "330e15ac1ca3663661a559c429735b43",
"sha256": "77b5b12e9fa6bb7ab623e7be5bfbd7523c83a2ea72c48f6f6f4d5e3df87ac896"
},
"downloads": -1,
"filename": "readthedocs_sphinx_ext-2.2.4-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "330e15ac1ca3663661a559c429735b43",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 11468,
"upload_time": "2023-12-13T08:47:38",
"upload_time_iso_8601": "2023-12-13T08:47:38.274961Z",
"url": "https://files.pythonhosted.org/packages/12/45/c0db0a248a10395a6d8d3cacff3a50279b62f0fe165c2b23341c43db7d18/readthedocs_sphinx_ext-2.2.4-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "32a117f5d630decdd36433116a5a516488554773933a4ed9b3c9580b53be4a78",
"md5": "c9688a9d10831dbd9c1826ee3465970b",
"sha256": "e99ed77d7618b2990d12953ba03722d1f354f7dd0f4097702383d40d2288ce3c"
},
"downloads": -1,
"filename": "readthedocs-sphinx-ext-2.2.4.tar.gz",
"has_sig": false,
"md5_digest": "c9688a9d10831dbd9c1826ee3465970b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 12474,
"upload_time": "2023-12-13T08:47:40",
"upload_time_iso_8601": "2023-12-13T08:47:40.407294Z",
"url": "https://files.pythonhosted.org/packages/32/a1/17f5d630decdd36433116a5a516488554773933a4ed9b3c9580b53be4a78/readthedocs-sphinx-ext-2.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-13 08:47:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "readthedocs",
"github_project": "readthedocs-sphinx-ext",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"circle": true,
"tox": true,
"lcname": "readthedocs-sphinx-ext"
}