[Django] #37134: Fontawesome console tab icons not appearing in locally generated html docs

4 views
Skip to first unread message

Django

unread,
May 31, 2026, 9:39:49 PM (2 days ago) May 31
to django-...@googlegroups.com
#37134: Fontawesome console tab icons not appearing in locally generated html docs
-------------------------------------+-------------------------------------
Reporter: James | Owner: James Beard
Beard |
Type: | Status: assigned
Cleanup/optimization |
Component: | Version: 6.0
Documentation |
Severity: Normal | Keywords: icon, fontawesome
Triage Stage: | Has patch: 0
Unreviewed |
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-------------------------------------+-------------------------------------
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:

1. the static file console-tabs.css contains a dynamic path meant to be
interpreted, however that file is just copied verbatim by sphinx
1. 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.
--
Ticket URL: <https://code.djangoproject.com/ticket/37134>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Jun 1, 2026, 8:22:14 AM (yesterday) Jun 1
to django-...@googlegroups.com
#37134: Fontawesome console tab icons not appearing in locally generated html docs
-------------------------------------+-------------------------------------
Reporter: James Beard | Owner: James
Type: | Beard
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 6.0
Severity: Normal | Resolution:
Keywords: icon, fontawesome | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Tim Graham):

* stage: Unreviewed => Accepted

--
Ticket URL: <https://code.djangoproject.com/ticket/37134#comment:1>

Django

unread,
9:29 AM (13 hours ago) 9:29 AM
to django-...@googlegroups.com
#37134: Fontawesome console tab icons not appearing in locally generated html docs
-------------------------------------+-------------------------------------
Reporter: James Beard | Owner: James
Type: | Beard
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 6.0
Severity: Normal | Resolution:
Keywords: icon, fontawesome | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by James Beard):

* has_patch: 0 => 1

Comment:

[https://github.com/django/django/pull/21407 PR]
--
Ticket URL: <https://code.djangoproject.com/ticket/37134#comment:2>
Reply all
Reply to author
Forward
0 new messages