Better figures and images - improved path handling & Pelican 3.3 fixes

This pull request improved the path handling in my Better Figures & Images plugin: making it more robust, better documented and fully compatible with Pelican 3.3.