From 68d8ca428411e777f245114bc1090f2de3ebe867 Mon Sep 17 00:00:00 2001 From: Johannes Kasimir Date: Wed, 5 Aug 2026 15:56:37 +0200 Subject: [PATCH 1/2] fix: fetch fontawesome as extra_css --- template/docs/mkdocs.yml.jinja | 3 +++ 1 file changed, 3 insertions(+) diff --git a/template/docs/mkdocs.yml.jinja b/template/docs/mkdocs.yml.jinja index af3a820..4a11149 100644 --- a/template/docs/mkdocs.yml.jinja +++ b/template/docs/mkdocs.yml.jinja @@ -98,6 +98,9 @@ extra: # Customization to be included by the theme extra_css: - assets/stylesheets/extra.css + # Work around ipywidgets loading its Font Awesome files relative to the HTML page. + # See https://github.com/jupyter-widgets/ipywidgets/issues/3658 + - https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.4/css/all.min.css extra_javascript: - assets/javascripts/extra.js From 5266ea941aba2af2d9de955bf99548e66ee331e1 Mon Sep 17 00:00:00 2001 From: Johannes Kasimir Date: Wed, 5 Aug 2026 16:01:15 +0200 Subject: [PATCH 2/2] fix: explain motivation --- template/docs/mkdocs.yml.jinja | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/template/docs/mkdocs.yml.jinja b/template/docs/mkdocs.yml.jinja index 4a11149..15ffe11 100644 --- a/template/docs/mkdocs.yml.jinja +++ b/template/docs/mkdocs.yml.jinja @@ -98,8 +98,8 @@ extra: # Customization to be included by the theme extra_css: - assets/stylesheets/extra.css - # Work around ipywidgets loading its Font Awesome files relative to the HTML page. - # See https://github.com/jupyter-widgets/ipywidgets/issues/3658 + # ipywidgets resolves its bundled Font Awesome fonts relative to the generated HTML + # page, where they do not exist. Load the font from CDN so widget icons render. - https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.4/css/all.min.css extra_javascript: