Building PDF version of the docs from LaTeX fails locally about message_ix HOT 1 OPEN

The supported image types for the sphinx LaTeXBuilder include both PNG and PDF despite the sphinx image docs claiming that LaTeX prefers PDF over PNG. Either way, we are also trying to include JPG, WEBP, and SVG files, which do not seem to be supported by LaTeX in sphinx. Note that when providing multiple formats of the same image, including it as image_name.* allows sphinx to choose the format it prefers for the current builder. Also note that the only directive allows you to write code that is used only for LaTeX or only for HTML.

In the past, some people reported having to follow a certain order in which LaTeX packages are imported. However, moving all of the packages that are reported after hyperref by us manually before it (one by one) did not change anything (those were sphinxmessages, unicode-math, and graphicx). This problem might also be about expansion but I'm not aware of any config settings there and we are not manually adding expansion commands where we should not.

For good measure, find here the sphinx docs on LaTeX customization.

from message_ix.