DBT文档自定义配置:修改默认标题与内置dbt logo的方法
dbt 文档自定义配置说明
1. 修改浏览器标签页标题与logo(favicon)
- 标签页标题修改:
你可以直接修改项目根目录下dbt_project.yml文件中的name字段值,该值默认会作为标签页的标题展示。如果需要设置和项目名不同的标题,可以在运行dbt docs generate命令后,手动编辑生成的target/index.html文件,修改<title>标签内的内容即可。 - 标签页favicon修改:
在项目根目录新建/assets文件夹,将你自定义的favicon文件命名为favicon.ico放入该文件夹。后续运行dbt docs generate时,工具会自动将该文件复制到生成的静态资源目录中,覆盖默认的dbt favicon。
2. 页面头部区域的dbt logo自定义
该logo支持自定义修改,操作方式如下:
- 将你需要替换的logo图片(推荐png或svg格式,尺寸适配头部高度即可)放入项目根目录的
/assets文件夹中,例如命名为custom_logo.png - 运行
dbt docs generate生成文档后,编辑target/index.html文件,搜索默认dbt logo的资源引用路径,将其替换为./assets/custom_logo.png即可。 - 如果你不想每次生成文档都手动修改,可以编写简单的字符替换脚本,配置为dbt的
on-run-end钩子,在每次文档生成完成后自动完成路径替换。
内容的提问来源于stack exchange,提问作者user961
相关产品推荐
相关产品推荐

