DBT 文档生成 - 如何为文档网站提供特定品牌

DBT docs generate - How to give the specific branding to the documentation website

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

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

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

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

时进行任何更改

这就是我要做的：

  • 找到index.html文件，在dbt installation directory添加行

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

    在 <head> 标签中。这样，您只需在更新 dbt

    时再次进行此更改

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

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

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