What's my plan?
Suite Growth, Professional, Enterprise, or Enterprise Plus
Support with Guide Professional or Enterprise
位置:知识管理 > 自定义设计 () > 选择主题 > 编辑 > 资产

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

本文章包含以下部分:
  • 为主题上传资产
  • 在主题代码中使用上传的资产
  • 替换主题中的资产
  • 删除主题资产

为主题上传资产

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

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

上传自己的主题资产

  1. 在知识管理中,单击侧栏中的自定义设计 ()。
  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. 在知识管理中,单击侧栏中的自定义设计 ()。
  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. 在知识管理中,单击侧栏中的自定义设计 ()。
  2. 单击您要编辑的主题上的自定义。
  3. 单击编辑代码。
  4. 在资产部分,找到您要替换的资产文件。
  5. 单击资产文件名末尾的选项菜单,然后选择替换。

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

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

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

删除主题资产

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

删除主题资产

  1. 在知识管理中,单击侧栏中的自定义设计 ()。
  2. 单击您要编辑的主题上的自定义。
  3. 单击编辑代码。

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

  6. 确认您要删除资产。

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

由 Zendesk 提供技术支持