您可以将图像和文件等资产上传到任何帮助中心主题。
为主题上传资产
您可以将图像和文件等资产上传到帮助中心。资产存储在云交付网络 (CDN) 的网页缓存中。网页缓存可降低带宽要求和服务器负载,并缩短响应时间。
主题有多种允许的文件类型,具体请参阅主题资产允许的文件类型。
上传自己的主题资产
- 在 Guide 中,单击侧栏中的自定义设计图标 ()。
- 单击您要编辑的主题上的自定义。
- 单击编辑代码。
- 在文件部分,单击添加新的,然后选择资产。
-
浏览选择文件。主题资产名称必须是唯一的,并且不能超过 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 资产助手。
在代码中使用资产变量和助手可以轻松替换主题中的资产,而无需编辑主题代码。请参阅替换主题中的资产。
在主题代码中使用上传的资产
- 在 Guide 中,单击侧栏中的自定义设计图标 ()。
- 单击您要编辑的主题上的自定义。
- 单击编辑代码。
- 在资产部分,单击您要使用的资产文件。
随即显示资产的各种表达式:
- 单击复制以在剪贴板中复制所需的资产表达式。
- 将资产表达式粘贴到主题代码中。
范例
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 文件中使用。
有关编辑主题代码的更多信息,请参阅自定义帮助中心主题。
替换主题中的资产
如以上在主题代码中使用上传的资产部分所述,使用资产变量和助手可以动态替换主题中的资产,而无需编辑主题代码。只需在系统上选择一个新资产文件即可更新主题。
- 在 Guide 中,单击侧栏中的自定义设计图标 ()。
- 单击您要编辑的主题上的自定义。
- 单击编辑代码。
- 在资产部分,找到您要替换的资产文件。
- 单击资产文件名末尾的选项菜单,然后选择替换。
- 在系统中选择一个新资产。
上传后,主题将由任何引用资产的变量或助手动态更新。更改会立即生效。
如果您在已发布帮助中心页面的 HTML 源代码中使用资产的完整 URL,则该资产不会被替换。指向资产的链接将断开,因为替换资产会更改已发布的资产 URL。因此,应避免在主题、页面模板或外部网页中使用已发布的资产 URL。
删除主题资产
您可以轻松删除不再在主题中使用的任何主题资产。
删除主题资产
- 在 Guide 中,单击侧栏中的自定义设计图标 ()。
- 单击您要编辑的主题上的自定义。
- 单击编辑代码。
- 在资产部分,找到您要删除的资产文件。
- 单击资产文件名末尾的选项菜单,然后选择删除资产。
- 确认您要删除资产。
该资产将从资产列表中移除。