Skip to main content

This Sphinx 1.0 extension executes programs during the build step and includes their screenshot into the documentation. GUI version of the sphinxcontrib.programoutput extension.

home: https://github.com/ponty/sphinxcontrib-programscreenshot

documentation: http://ponty.github.com/sphinxcontrib-programscreenshot

Basic usage

.. program-screenshot:: xmessage hello
    :prompt:

How it works

  1. start Xvfb headless X server using pyvirtualdisplay

  2. redirect program display to Xvfb server by setting $DISPLAY variable.

  3. wait some seconds

  4. take screenshot by pyscreenshot which needs scrot.

  5. use .. image:: directive to display image

Installation

General

  • install Xvfb and Xephyr

  • install PIL

  • install scrot

  • install pip

  • install the program:

    # as root
    pip install sphinxcontrib-programscreenshot

Ubuntu

sudo apt-get install python-pip
sudo apt-get install scrot
sudo apt-get install xvfb
sudo apt-get install xserver-xephyr
sudo apt-get install python-imaging
sudo pip install sphinxcontrib-programscreenshot

Uninstall

# as root
pip uninstall sphinxcontrib-programscreenshot

Metadata

Release files for sphinxcontrib-programscreenshot 0.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sphinxcontrib-programscreenshot 0.0.5
File Size Uploaded
sphinxcontrib-programscreenshot-0.0.5.tar.gz 7.9 kB Details

Release files / sphinxcontrib-programscreenshot-0.0.5.tar.gz

Download URL sphinxcontrib-programscreenshot-0.0.5.tar.gz
Size 7.9 kB
Tags Source
SHA-256 checksum
How to use checksums
2e44e8afea76ad566bc69454557b39c157c58fcac78eb1106bfdad6e11da0737
BLAKE2b-256 checksum
How to use checksums
d9d652c2c0a650b428dd4f2cd931043ff40bed681ce3ce32d8d138288a5b7aec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page