Sphinx extension to include screenshot of programs
Project description
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
start Xvfb headless X server using PyVirtualDisplay
redirect program display to Xvfb server by setting $DISPLAY variable.
wait some seconds
take screenshot by pyscreenshot which needs scrot.
use .. image:: directive to display image
Installation
General
install PIL
install scrot
install setuptools or pip
install the program:
if you have setuptools installed:
# as root easy_install sphinxcontrib-programscreenshot
if you have pip installed:
# as root pip install sphinxcontrib-programscreenshot
Ubuntu
sudo apt-get install python-setuptools sudo apt-get install scrot sudo apt-get install xvfb sudo apt-get install xserver-xephyr sudo apt-get install python-imaging sudo easy_install sphinxcontrib-programscreenshot
Uninstall
# as root pip uninstall sphinxcontrib-programscreenshot
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for sphinxcontrib-programscreenshot-0.0.2dev-20110223.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e96075d8da2bcea211300803cc2c6cc260b7ee41a29d2cf699234a46b0ebc7f5 |
|
MD5 | 848dc628172f14222fb76613a38d0d7f |
|
BLAKE2b-256 | e06edd868e6f17e223b278ba883dcf446bcc31454afb9fd749ee042389e08865 |