Sphinx favicon

cloud-atlas.io Nginx日志时,可以看到每次浏览器请求都会记录

Nginx日志显示每次访问都缺少 favicon.ico 文件
192.168.7.245 - - [01/Jan/2025:11:31:31 +0800] "GET /favicon.ico HTTP/1.1" 404 125 "https://docs.cloud-atlas.io/discovery/infrastructure/opencompute/index.html" "Mozilla/5.0 (X11; Linux x86_64; rv:133.0) Gecko/20100101 Firefox/133.0"

虽然没有太大影响,但是每次看到页面加载时候 Load 箭头在转动感觉也很难受,所以检查如何解决

  • 如果页面头部没有嵌入指定合适的 favicon ,那么默认浏览器会去下载WEB服务器根部的 favicon.ico 文件,这也是一种托底方案: Nginx favicon.ico

  • 比较优雅的方案还是在Sphinx内部解决,在 conf.py 中添加如下代码:

添加 favicon 配置
html_favicon = '_static/favicon.png'

备注

favicon.io 提供了非常好的在线转换,不仅可以转换图片,还能转换文字和Emoji。例如,我简单用它的 TEXT -> ICO 转换了

参考