Opened 50 minutes ago
#37134 assigned Cleanup/optimization
Fontawesome console tab icons not appearing in locally generated html docs
| Reported by: | James Beard | Owned by: | James Beard |
|---|---|---|---|
| Component: | Documentation | Version: | 6.0 |
| Severity: | Normal | Keywords: | icon, fontawesome |
| Cc: | Triage Stage: | Unreviewed | |
| Has patch: | no | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | no | UI/UX: | no |
Description
When generating HTML django docs locally the console tab icons (Windows, Linux, Mac) are broken and appear as missing unicode squares.
To reproduce, check out the django source, install docs dependencies, and run make html in docs/. On relevant pages e.g. http://localhost:3000/topics/install the icons in the tabs above the console blocks look like this: □/□ □
The cause is in the default djangodocs theme and is twofold:
- the static file console-tabs.css contains a dynamic path meant to be interpreted, however that file is just copied verbatim by sphinx
- the @font-face name defined in fa-brands.min.css doesn't match what's used elsewhere in the theme CSS
Have a fix already so happy to take ownership if accepted.
Note:
See TracTickets
for help on using tickets.