Skip to main content

Sphinx extension to include program output

Project description

https://secure.travis-ci.org/lunaryorn/sphinxcontrib-programoutput.png

http://sphinxcontrib-programoutput.readthedocs.org

A Sphinx extension to literally insert the output of arbitrary commands into documents, helping you to keep your command examples up to date.

Installation

Install this extension from the Cheeseshop:

pip install sphinxcontrib-programoutput

The extension requires Sphinx 1.1 and Python 2.6 or Python 3.1 at least.

Usage

Just add this extension to extensions:

extensions = ['sphinxcontrib.programoutput']

Now you’ve two new directives program-output and command-output to insert the output of programs. The former just inserts the output:

.. program-output:: python -V

Output:

Python 2.7.1

The latter directive mimics a shell session, and is intended to show examples:

.. command-output:: python -V

Output:

$ python -V
Python 2.7.1

Please refer to the documentation for comprehensive information about usage and configuration of this extension.

Support

Please report issues to the issue tracker if you have trouble or found a bug in this extension, but respect the following guidelines:

  • Check that the issue has not already been reported.
  • Check that the issue is not already fixed in the master branch.
  • Open issues with clear title and a detailed description in grammatically correct, complete sentences.

Development

The source code is hosted on Github:

git clone https://github.com/lunaryorn/sphinxcontrib-programoutput

Please fork the repository and send pull requests with your fixes or features, but respect these guidelines:

Project details


Release history Release notifications

History Node

0.11

History Node

0.10

This version
History Node

0.8

History Node

0.8.dev20161101

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
sphinxcontrib_programoutput-0.8-cp27-none-any.whl (9.0 kB) Copy SHA256 hash SHA256 Wheel cp27 Nov 1, 2016
sphinxcontrib_programoutput-0.8-cp35-none-any.whl (9.0 kB) Copy SHA256 hash SHA256 Wheel cp35 Nov 1, 2016
sphinxcontrib_programoutput-0.8-py3-none-any.whl (9.0 kB) Copy SHA256 hash SHA256 Wheel py3 Nov 2, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page