将自己的主题资产用于帮助中心

我的服务模式是什么？

Suite

Growth、Professional、Enterprise 或 Enterprise Plus

Support 以及

Guide 所有服务模式

快速查看：Guide 管理员 > 自定义设计 > 选择主题 > 编辑 > 资产

您可以将图像和文件等资产上传到任何帮助中心主题。

本文章包含以下部分：

• 为主题上传资产
• 在主题代码中使用上传的资产
• 替换主题中的资产
• 删除主题资产

为主题上传资产

您可以将图像和文件等资产上传到帮助中心。资产存储在云交付网络 (CDN) 的网页缓存中。网页缓存可降低带宽要求和服务器负载，并缩短响应时间。

主题有多种允许的文件类型，具体请参阅主题资产允许的文件类型。

上传自己的主题资产

1. 在 Guide 中，单击侧栏中的自定义设计图标 ()。
2. 单击您要编辑的主题上的自定义。
3. 单击编辑代码。

   

4. 在文件部分，单击添加新的，然后选择资产。

   

5. 浏览选择文件。主题资产名称必须是唯一的，并且不能超过 50 个字符。资产名称可包含以下任意内容：字母、数字、点、减号、加号、下划线和短划线。资产名称不区分大小写，因此您不能同时拥有名为 assets.jpg 和 Asset.jpg 的资产。

   资产文件将添加到资产文件列表中。

主题资产允许的文件类型

下表显示了允许作为主题资产的文件类型。资产允许的文件类型仅限于帮助中心主题中使用的文件类型。

资产类型	允许的文件类型
图像	jpg、jpeg、png、gif、svg、webp、tiff、tif、bmp、ico、webm
字体	woff2、woff、eot、otf、ttf、svg
文本文件	js、css、html、json、txt、xml
其他	mp4、swf、wav、ogg、mp3

丰富内容文件类型（例如 Microsoft PowerPoint、Microsoft Word 和 PDF）可以是文章附件，但不能是主题资产。

在主题代码中使用上传的资产

您可以在主题的 style.css 文件或其模板中引用上传的资产。在 style.css 文件中，可以使用 Guide 提供的资产路径变量；在模板中，可以使用 Curlybars 资产助手。

在代码中使用资产变量和助手可以轻松替换主题中的资产，而无需编辑主题代码。请参阅替换主题中的资产。

注意：在主题的 script.js 文件中，不能使用路径变量或助手。

在主题代码中使用上传的资产

1. 在 Guide 中，单击侧栏中的自定义设计图标 ()。
2. 单击您要编辑的主题上的自定义。
3. 单击编辑代码。
4. 在资产部分，单击您要使用的资产文件。

   随即显示资产的各种表达式：

   

5. 单击复制以在剪贴板中复制所需的资产表达式。
6. 将资产表达式粘贴到主题代码中。

范例

style.css

.class-name { 
  background: url($assets-backpack2-jpeg);
}

值 assets-backpack2-jpeg 是变量，包含资产的相对路径。

.hbs 文件

在 html 标记中：

<img src="{{asset 'backpack2.jpeg'}}">

在样式标签中：

<style>
  .class-name { 
    background: url("{{asset 'backpack2.jpeg'}}");
  }
</style>

在脚本标签中：

<script>
  var assetsBackpack2 = "{{asset 'backpack2.jpeg'}}";
</script>

资产助手可以插入模板的脚本标签中，但无法在 script.js 文件中使用。

有关编辑主题代码的更多信息，请参阅自定义帮助中心主题。

替换主题中的资产

如以上在主题代码中使用上传的资产部分所述，使用资产变量和助手可以动态替换主题中的资产，而无需编辑主题代码。只需在系统上选择一个新资产文件即可更新主题。

替换资产

1. 在 Guide 中，单击侧栏中的自定义设计图标 ()。
2. 单击您要编辑的主题上的自定义。
3. 单击编辑代码。
4. 在资产部分，找到您要替换的资产文件。
5. 单击资产文件名末尾的选项菜单，然后选择替换。

   

6. 在系统中选择一个新资产。

   上传后，主题将由任何引用资产的变量或助手动态更新。更改会立即生效。

   如果您在已发布帮助中心页面的 HTML 源代码中使用资产的完整 URL，则该资产不会被替换。指向资产的链接将断开，因为替换资产会更改已发布的资产 URL。因此，应避免在主题、页面模板或外部网页中使用已发布的资产 URL。

删除主题资产

您可以轻松删除不再在主题中使用的任何主题资产。

删除主题资产

1. 在 Guide 中，单击侧栏中的自定义设计图标 ()。
2. 单击您要编辑的主题上的自定义。
3. 单击编辑代码。

   

4. 在资产部分，找到您要删除的资产文件。
5. 单击资产文件名末尾的选项菜单，然后选择删除资产。

   

6. 确认您要删除资产。

   该资产将从资产列表中移除。