-
Notifications
You must be signed in to change notification settings - Fork 65
Description
Describe the bug
context
When I build a PDF, which includes fontawesome icons, using latexpdf builder using Sphinx 8.2.3, the build fails with error
(/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5.sty
! Package fontawesome5 Error: Incompatible version of Font Awesome already
(fontawesome5) loaded
The PoC is very simple: just use code from your docs (see below)
expectation
I expected a successful build, because the same code builds with Sphinx 7.2.6.
problem
I understand this should be of little impact, as it is a very limited use case (I don't believe building PDFs is the main output when using sphinx), but this could impact
Reproduce the bug
- use code below in an empty document
- An icon :fas:`spinner;sd-text-primary`, some more text.
- An icon :fab:`github`, some more text.
- An icon :fab:`gitkraken;sd-text-success fa-xl`, some more text.
- An icon :fas:`skull;sd-text-danger`, some more text.
- add to conf.py lines
latex_engine = 'lualatex'
sd_fontawesome_latex = True
- build using
make latexpdf - See build fail
This should be due to two main causes:
-
the builder includes
\usepackage{fontawesome}, which loads(/usr/share/texlive/texmf-dist/tex/latex/fontawesome/fontawesome.sty (/usr/share/texlive/texmf-dist/tex/latex/fontawesome/fontawesomesymbols-generic.tex) (/usr/share/texlive/texmf-dist/tex/latex/fontawesome/fontawesomesymbols-xeluatex.tex) -
sd_fontawesome_latex = Truecauses to add\usepackage{fontawesome5}(/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5.sty), which is incompatible with the other package and does not define command\faicon, but\faIcon.
However, note that by manually deleting \usepackage{fontawesome}, and replacing \faicon, with \faIcon, the build is successful.
List your environment
Sphinx==8.2.3
sphinx_design==0.6.1
No response