pdf generation - Using Sphinx docs how can I specify png image formats for HTML builds and pdf image formats for Latex/PDF builds?

Question

Using sphinx doc generator, I am trying to use .png images for the HTML builds of the documentation, and then I want to have the .svg images used for the PDF/LATEx builds.

Anyone know how to "tag" sections as "HTML build"-only and "Latex build"-only?

Cheers

Answer 1

Take a look at these options:

1. Image filename wildcard:

   .. image:: gnu.* 
   

   From the documentation: "For instance, if the file name gnu.* was given and two files gnu.pdf and gnu.png existed in the source tree, the LaTeX builder would choose the former, while the HTML builder would prefer the latter."

2. The only directive:

   .. only:: latex
   
      This appears only in LaTeX output.
   
   .. only:: html
   
      This appears only in HTML output.