NOTES

don't use '.. class::' instead use '.. cssclass::' (https://github.com/ralsina/rst2pdf/issues/503)
Requires:
inkscape (will fall back to svg2rlg but it doesn't work very well)
python2
pip
virtualenv

To add a border on the left edge of an image (to account for floating image issues):
devo8:
convert input.png -matte -background none -splice 10x0 output.png
devo10:
convert input.png -type truecolor -matte -background white -splice 10x0 -transparent white PNG24:output.png
convert input.png -matte -background white -splice 10x0 output.png
(reportlab doesn't detect alpha properly on devo10 screenshots)

rst2pdf version is: 
https://github.com/PhracturedBlue/rst2pdf
version: c021d755749328c75486c012fe462483cfeb5c1b