Jupyter Book中Sphinx-exercise指令图标渲染异常求助

以下是几个针对性的解决步骤，按优先级尝试：

1. 升级sphinx-exercise到最新版本 #

旧版本的sphinx-exercise可能存在图标类名与新版Font Awesome不兼容的问题，先执行升级：

pip install --upgrade sphinx-exercise

2. 强制指定图标类名 #

在Jupyter Book的_config.yml中，通过sphinx配置自定义sphinx-exercise的图标类，适配当前环境的Font Awesome版本：

sphinx:
  config:
    # 适配Font Awesome 4.x
    exercise_icon_class: "fa fa-pencil"
    # 若使用Font Awesome 5+/6.x，替换为下面的配置
    # exercise_icon_class: "fa-solid fa-pencil"

3. 自定义CSS强制修正图标 #

如果上述方法无效，直接通过自定义CSS覆盖图标样式：

1. 在项目的_static目录下创建custom.css文件，添加内容：

.sphinx-exercise-icon::before {
  content: "\f303" !important; /* 铅笔图标的Unicode，对应fa-pencil */
  font-family: "Font Awesome 6 Free" !important; /* 根据实际Font Awesome版本调整，比如"Font Awesome 5 Free" */
  font-weight: 900 !important; /* 实心图标需设置该权重 */
}

2. 在_config.yml中启用这个自定义CSS：

html_static_path: ["_static"]
html_css_files:
  - custom.css

4. 检查扩展冲突 #

排查是否有其他Sphinx扩展（如sphinx-panels、sphinx-book-theme的自定义配置）修改了Font Awesome的全局样式或图标类映射，暂时禁用其他非必要扩展测试是否恢复正常。

内容的提问来源于stack exchange，提问作者daviddesancho