Use Font Awesome in body text

[jordi-torrents]

How should I use fa-brands icons from Font Awesome? I tried with :fa:`fa-brands fa-google-play but I get a "broken" icon. I can fix it if I add

.fa {
    font: normal normal normal 14px/1 FontAwesome;
    font-size: inherit;
}

to a .css file imported in conf.py with html_css_files = ... but I have no idea what I'm doing. Am I doing it right?

[12rambau]

the :fa: role is coming from sphinx design itself and my guess is that the underlying font in "Fontawesome" instead of "Fontawesome brand" it's not made to be used with the full description of the fa icons but only the name of the glyph. You can report the issue to them if you want.

In the meantime I developped some time ago another sphinx extention that do exactly what you need: https://github.com/sphinx-contrib/icon. have a look.

[jordi-torrents]

Thanks for your answer. Do you think my workaround with the css piece could break something in somewhere else? In Sphinx or your theme? I really don't know what it's doing...

[drammock]

I think it will work without your custom CSS if you do :fab: instead of :fa: