部署Voila应用时如何设置自定义favicon?
Voila(Heroku模板部署)自定义favicon配置方案
自定义favicon是Voila原生支持的功能,使用官方voila-heroku模板部署时配置失败,基本都是静态资源路径没配对,按下面步骤操作就能生效:
- 准备favicon文件
提前制作好要替换的favicon,推荐用标准favicon.ico格式(兼容所有浏览器),也可以用png格式。在项目根目录新建static文件夹(如果已有就直接用),把favicon文件放进去。 - 新增Voila配置指定favicon路径
在项目根目录新建voila.json配置文件,写入如下内容,注意路径和你放的favicon文件名完全对应:{ "VoilaConfiguration": { "static_root": "static", "favicon": "static/favicon.ico" } } - 核对启动命令
打开项目根目录的Procfile,确保启动命令没有额外指定其他会覆盖静态资源规则的参数,保持基础格式即可:web: voila --port=$PORT --no-browser --enable_nbextensions=True 你自己的notebook文件名.ipynb - 部署后清缓存验证
把修改后的代码推送到Heroku完成重新部署后,不要直接刷新页面,先按Ctrl+F5(Windows)/Cmd+Shift+R(Mac)强制清空浏览器缓存加载,部分情况下Heroku的静态资源缓存会延迟1-2分钟生效,稍等再刷新即可。
避坑提醒:不要把favicon放到多层嵌套的文件夹里,路径越简单越容易被Voila识别,路径错误时Voila会自动回退加载内置的默认favicon,不会抛出显式报错,很容易误以为功能不支持。
内容的提问来源于stack exchange,提问作者Pierrick Rambaud
相关产品推荐
相关产品推荐

