At Sphinx release 7.4.0, the defaults for PDF outputs have been enhanced regarding rendering of admonitions (sphinx-doc/sphinx#12508). One can see the effect in current PDFs: admonitions (such as note, seealso, important, warning, etc...) are nicely rendered in PDF output. But are lacking icons. For this, Sphinx needs latex package fontawesome5.
Unfortunately Ubuntu packaging delivers it only via the texlive-fonts-extra. Sphinx PDF build process detects automatically if fontawesome5 is available or not and simply drops icons from title bars of admonitions if not; it may fall-back to fontawesome but Ubuntu also delivers the latter only as part of texlive-fonts-extra.
For Python PDF docs to have the icons the following change appears to be the one needed:
At Sphinx release 7.4.0, the defaults for PDF outputs have been enhanced regarding rendering of admonitions (sphinx-doc/sphinx#12508). One can see the effect in current PDFs: admonitions (such as
note
,seealso
,important
,warning
, etc...) are nicely rendered in PDF output. But are lacking icons. For this, Sphinx needs latex packagefontawesome5
.Unfortunately Ubuntu packaging delivers it only via the
texlive-fonts-extra
. Sphinx PDF build process detects automatically iffontawesome5
is available or not and simply drops icons from title bars of admonitions if not; it may fall-back tofontawesome
but Ubuntu also delivers the latter only as part oftexlive-fonts-extra
.For Python PDF docs to have the icons the following change appears to be the one needed:
Without it, PDFs are built fine. But will lack icons in admonitions title bars.