Bug 2496858 - Fontawesome icons are missing in the generated output
Summary: Fontawesome icons are missing in the generated output
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: python-pydata-sphinx-theme
Version: rawhide
Hardware: Unspecified
OS: Linux
unspecified
high
Target Milestone: ---
Assignee: Jerry James
QA Contact:
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2026-07-03 13:52 UTC by Corentin Noël
Modified: 2026-08-06 17:15 UTC (History)
3 users (show)

Fixed In Version: python-pydata-sphinx-theme-0.20.0-2.fc44 python-pydata-sphinx-theme-0.20.0-3.fc44
Clone Of:
Environment:
Last Closed: 2026-08-06 17:15:56 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)
Symlink to FontAwesome fonts (4.62 KB, patch)
2026-07-24 13:21 UTC, Corentin Noël
no flags Details | Diff

Description Corentin Noël 2026-07-03 13:52:34 UTC
I'm using sphinx with the pydata theme and I can't see fontawesome icons there, I can see in the browser console for instance:
GET
http://127.0.0.1:9000/_static/vendor/fontawesome/webfonts/fa-solid-900.woff2
[HTTP/1 404 File not found 1ms]

This seems to only be an issue with the fedora version of the pydata theme.

Reproducible: Always

Steps to Reproduce:
1. Create a documentation using a `note` field for instance (that is using a font-awesome icon)
Actual Results:
The icon is not showing

Expected Results:
The icon should be showing

Comment 1 Jerry James 2026-07-10 21:13:41 UTC
I think I see the problem.  I have built version 0.20.0 with a fix for this issue in Rawhide and Fedora 44.  Let me know if the update fixes the issue for you.

Comment 2 Fedora Update System 2026-07-10 21:13:55 UTC
FEDORA-2026-6324ca2e6b (python-pydata-sphinx-theme-0.20.0-1.fc44) has been submitted as an update to Fedora 44.
https://bodhi.fedoraproject.org/updates/FEDORA-2026-6324ca2e6b

Comment 3 Fedora Update System 2026-07-11 01:34:53 UTC
FEDORA-2026-6324ca2e6b has been pushed to the Fedora 44 testing repository.
Soon you'll be able to install the update with the following command:
`sudo dnf upgrade --enablerepo=updates-testing --refresh --advisory=FEDORA-2026-6324ca2e6b`
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2026-6324ca2e6b

See also https://fedoraproject.org/wiki/QA:Updates_Testing for more information on how to test updates.

Comment 4 Corentin Noël 2026-07-13 14:08:57 UTC
I tried with this update and no luck, on the web console I now get:
```
Unknown descriptor ‘src:local("fontawesome-free-fonts/Font Awesome 7 Free-Solid-900") format("opentype")’ in @font-face rule.  Skipped to next declaration.
```

Comment 5 Corentin Noël 2026-07-13 14:41:59 UTC
Here is a minimal QA reproducer:

conf.py:
```
project = 'test'
copyright = '2026, test'
author = 'test'

html_theme = "pydata_sphinx_theme"
```

index.rst:
```
test documentation
==================

Add your content using ``reStructuredText`` syntax. See the
`reStructuredText <https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html>`_
documentation for details.

.. note:: Test note

.. toctree::
   :maxdepth: 2
   :caption: Contents:
```

Run `sphinx-build . build` to generate the output in the `build` directory then one can check the output with a simple `python3 -m http.server --bind 127.0.0.1 9000` in the build directory

Comment 6 Fedora Update System 2026-07-15 01:23:42 UTC
FEDORA-2026-6324ca2e6b has been pushed to the Fedora 44 testing repository.
Soon you'll be able to install the update with the following command:
`sudo dnf upgrade --enablerepo=updates-testing --refresh --advisory=FEDORA-2026-6324ca2e6b`
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2026-6324ca2e6b

See also https://fedoraproject.org/wiki/QA:Updates_Testing for more information on how to test updates.

Comment 7 Jerry James 2026-07-15 01:47:17 UTC
Sorry about that.  Unbundling fonts is hard.  I think I've got it this time.  At least, when I try your reproducer (many thanks for that!) I now see the expected icons on the upper right.

Comment 8 Corentin Noël 2026-07-15 06:26:37 UTC
The upper-right icon is a bundled SVG, the goal is to have the right icon appearing next to the "Test note" frame.

Right now I'm still getting:

```
Unknown descriptor ‘src:local("fontawesome-7-free-fonts/Font Awesome 7 Free-Solid-900") format("opentype")’ in @font-face rule.  Skipped to next declaration.
```
in the web console

Comment 9 Fedora Update System 2026-07-23 01:18:38 UTC
FEDORA-2026-6324ca2e6b (python-pydata-sphinx-theme-0.20.0-2.fc44) has been pushed to the Fedora 44 stable repository.
If problem still persists, please make note of it in this bug report.

Comment 10 Corentin Noël 2026-07-24 13:21:58 UTC
Created attachment 2152579 [details]
Symlink to FontAwesome fonts

Here is a suggestion of one possible way to correctly unbundle the fonts but still allow them to be included in the generated documentation

Comment 11 Jerry James 2026-07-28 16:55:25 UTC
Thank you! I will do builds with that approach today.

Comment 12 Fedora Update System 2026-07-28 17:43:00 UTC
FEDORA-2026-b2b0c967fd (python-pydata-sphinx-theme-0.20.0-3.fc44) has been submitted as an update to Fedora 44.
https://bodhi.fedoraproject.org/updates/FEDORA-2026-b2b0c967fd

Comment 13 Fedora Update System 2026-07-29 01:49:16 UTC
FEDORA-2026-b2b0c967fd has been pushed to the Fedora 44 testing repository.
Soon you'll be able to install the update with the following command:
`sudo dnf upgrade --enablerepo=updates-testing --refresh --advisory=FEDORA-2026-b2b0c967fd`
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2026-b2b0c967fd

See also https://fedoraproject.org/wiki/QA:Updates_Testing for more information on how to test updates.

Comment 14 Fedora Update System 2026-08-06 17:15:56 UTC
FEDORA-2026-b2b0c967fd (python-pydata-sphinx-theme-0.20.0-3.fc44) has been pushed to the Fedora 44 stable repository.
If problem still persists, please make note of it in this bug report.


Note You need to log in before you can comment on or make changes to this bug.