DocOnce writing tips

Figures and movies:

• Prepare figures in the right format: EPS for latex, PDF for pdflatex, PNG, GIF or JPEG for HTML formats (html, and HTML output from sphinx, rst, pandoc). One can omit the figure file extension and doconce will pick the most appropriate file for the given output format.
• Let plotting programs produce both PDF/EPS and PNG files. (Recall that PDF and EPS are vector graphics formats that can scale to any size with much higher quality than PNG or other bitmap formats.)
• Use doconce combine_images to combine several images into one.
• Store all figures in a directory (tree) with name fig or fig-X, where X is some short logical name for the current document.
• Store all movies in a directory (tree) with name mov or mov-X.
• Favor the movie formats MP4, WebM, and Ogg (best suited for modern browsers).