Metadata-Version: 2.1
Name: Sphinx-Substitution-Extensions
Version: 2019.4.4.1
Summary: Extensions for Sphinx which allow for substitutions.
Home-page: https://github.com/adamtheturtle/sphinx-substitution-extensions
Author: Adam Dangoor
Author-email: adamdangoor@gmail.com
License: Apache License, Version 2.0
Keywords: sphinx rst documentation
Platform: UNKNOWN
Classifier: Operating System :: POSIX
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python :: 3.5
Classifier: License :: OSI Approved :: Apache Software License
Requires-Dist: sphinx-prompt (==1.1.0)
Requires-Dist: sphinx (==2.0.0)
Provides-Extra: dev
Requires-Dist: autoflake (==1.2) ; extra == 'dev'
Requires-Dist: check-manifest (==0.37) ; extra == 'dev'
Requires-Dist: doc8 (==0.8.0) ; extra == 'dev'
Requires-Dist: dulwich (==0.19.11) ; extra == 'dev'
Requires-Dist: flake8-commas (==2.0.0) ; extra == 'dev'
Requires-Dist: flake8-quotes (==1.0.0) ; extra == 'dev'
Requires-Dist: flake8 (==3.7.7) ; extra == 'dev'
Requires-Dist: isort (==4.3.16) ; extra == 'dev'
Requires-Dist: mypy (==0.700) ; extra == 'dev'
Requires-Dist: mypy-mypyc (==0.670) ; extra == 'dev'
Requires-Dist: pip-check-reqs (==2.0.3) ; extra == 'dev'
Requires-Dist: pydocstyle (==3.0.0) ; extra == 'dev'
Requires-Dist: pyenchant (==2.0.0) ; extra == 'dev'
Requires-Dist: pygithub (==1.43.5) ; extra == 'dev'
Requires-Dist: pylint (==2.3.1) ; extra == 'dev'
Requires-Dist: pyroma (==2.4) ; extra == 'dev'
Requires-Dist: pytest-cov (==2.6.1) ; extra == 'dev'
Requires-Dist: pytest (==4.4.0) ; extra == 'dev'
Requires-Dist: twine (==1.13.0) ; extra == 'dev'
Requires-Dist: vulture (==1.0) ; extra == 'dev'
Requires-Dist: yapf (==0.26.0) ; extra == 'dev'

|Build Status| |codecov| |requirements| |PyPI|

Sphinx Substitution Extensions
==============================

Extensions for Sphinx which allow substitutions.

.. contents::

Installation
------------

.. code:: console

   $ pip install Sphinx-Substitution-Extensions

This supports Python 3.5+.

Setup
~~~~~

* Add the following to ``conf.py``:

.. code:: python

   extensions += ['sphinx-prompt', 'sphinx_substitution_extensions']

* Set the following variable in ``conf.py``:

.. code:: python

   substitutions = [
       ('|release|', '0.1'),
       ('|author|', 'Eleanor'),
   ]

This will replace ``|release|`` in the new directives with ``0.1``, and ``|author|`` with ``Eleanor``.

Directives
----------

``substitution-code-block``
~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code:: rst

   .. substitution-code-block:: bash

      echo "|author| released version |release|"

This is an extension of Sphinx's built-in `code-block`_ directive, and adds replacement functionality.

``substitution-prompt``
~~~~~~~~~~~~~~~~~~~~~~~

.. code:: rst

   .. substitution-prompt:: bash

      echo "|author| released version |release|"

This is an extension of `sphinx-prompt`_.

``substitution-prompt`` acts similarly to `sphinx-prompt`_, and adds replacement functionality.

Credits
-------

``sphinx-prompt`` authors
~~~~~~~~~~~~~~~~~~~~~~~~~

Thanks to `@sbrunner`_ and other contributors for `sphinx-prompt`_.
``substitution-prompt`` is based on `sphinx-prompt`_.

ClusterHQ Developers
~~~~~~~~~~~~~~~~~~~~

This package is largely inspired by code written for Flocker by ClusterHQ.
Developers of the relevant code include, at least, Jon Giddy and Tom Prince.

Contributing
------------

See `CONTRIBUTING.rst <./CONTRIBUTING.rst>`_.

.. |Build Status| image:: https://travis-ci.com/adamtheturtle/sphinx-substitution-extensions.svg?branch=master
    :target: https://travis-ci.com/adamtheturtle/sphinx-substitution-extensions
.. _sphinx-prompt: https://github.com/sbrunner/sphinx-prompt
.. _code-block: http://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-code-block
.. _@sbrunner: https://github.com/sbrunner
.. |codecov| image:: https://codecov.io/gh/adamtheturtle/sphinx-substitution-extensions/branch/master/graph/badge.svg
  :target: https://codecov.io/gh/adamtheturtle/sphinx-substitution-extensions
.. |requirements| image:: https://requires.io/github/adamtheturtle/sphinx-substitution-extensions/requirements.svg?branch=master
     :target: https://requires.io/github/adamtheturtle/sphinx-substitution-extensions/requirements/?branch=master
     :alt: Requirements Status
.. |PyPI| image:: https://badge.fury.io/py/Sphinx-Substitution-Extensions.svg
    :target: https://badge.fury.io/py/Sphinx-Substitution-Extensions


