DBT docs generate - 如何为文档网站提供特定品牌

Posted

技术标签:

【中文标题】DBT docs generate - 如何为文档网站提供特定品牌【英文标题】:DBT docs generate - How to give the specific branding to the documentation website 【发布时间】:2021-11-14 21:23:31 【问题描述】:

如何用 dbt docs generate 命令生成的网站标题中的其他图像替换 DBT 徽标。

【问题讨论】:

【参考方案1】:

该文档包含一个 index.html 文件,该文件从工件文件 (source) 加载数据。

如果您编辑index.html 文件,您将能够根据需要对其进行自定义。请注意,每次运行 dbt docs generate 时,该文件都会重新复制到您的目标文件夹中,因此您需要一些机制来将工件复制到新 index.html` 所在的任何位置,或者用您自定义的文件覆盖该文件版本。

【讨论】:

如何只覆盖 index.html 的某些部分,同时保留其他部分。【参考方案2】:

如果您更改源文件夹中的文件,我相信每次运行dbt docs generate 时都会将index.html 文件从dbt installation folder 复制到target 文件夹中。您可以从该目录自定义index.html 文件,然后您不必担心在运行dbt docs generate 时进行任何更改。

这就是我要做的:

dbt installation directory中找到index.html文件添加行

 <link rel='stylesheet' href='/styles.css' /> 

&lt;head&gt; 标记中。这样,您只需在更新dbt时再次进行此更改

在您的target 文件夹中添加一个styles.css 文件,然后定位dbt 徽标的类。如果你改变标志的背景颜色,你应该没问题,你不必每次运行dbt docs generate时都重新复制。

 .logo 
     background-image: url(<<path or url to your image>>);
     background-color: transparent;

您可以根据自己的喜好调整background-repeat, background-position, background-size, background-color等其他属性。

【讨论】:

以上是关于DBT docs generate - 如何为文档网站提供特定品牌的主要内容,如果未能解决你的问题,请参考以下文章

dbt 的知识文档管理

如何为 Ejabberd 自定义模块生成文档?

dbt(数据构建工具)神社模块-'dict object'没有属性're'

在工作 dbt 项目中调用 packages.yml 中的 git repo

如何为三星 S7 启用 USB 调试

eclipse如何为java项目生成java Doc