源代码编辑器可让您编辑帮助中心的文章和内容块的 HTML 源代码。这使您可以使用标准所见即所得编辑器无法实现的方式自定义帮助中心内容并设置其样式。
编辑文章源代码
您可以使用文章源代码编辑器编辑文章的 HTML,以自定义帮助中心文章。
- 在帮助中心或 Guide 管理员中,创建或编辑文章或内容块。
- 在文章或内容块中,单击源代码图标 ()。
- 在源代码编辑器中,创建或编辑您要使用的源代码。有关受支持元素的列表,请参阅 受支持的 HTML 以获取帮助中心文章 。
- 单击 应用 以保存编辑并关闭源代码视图。
清理文章源代码中的样式
当您从 HTML 页面复制粘贴内容到帮助文章中时,可能会带有不需要的样式,使文章源代码杂乱无章,影响帮助中心的一致性。您可以使用源代码编辑器中的“清理样式”按钮,删除任何对于文章编辑器工作而言并非必不可少的内联样式。
- 在帮助中心或 Guide 管理员中,创建或编辑文章或内容块。
- 在文章或内容块中,单击源代码图标 ()。
源代码编辑器随即打开,显示所有代码和内联样式。
- 在源代码编辑器中,单击 清理样式。
不受支持的内联样式将从源代码视图中移除。
- 单击 应用 以保存编辑并关闭源代码视图。
- 单击“ 保存 ”以保存更改。
编辑源代码时的重要注意事项
空白的 HTML 容器元素
Zendesk 会自动移除大多数空白的容器元素,例如 i
或 span
。这些元素通常必须包含要呈现的内容。Zendesk 无法移除空白 p
工单标签。取而代之的是,Zendesk 插入
作为元素的内容。例如:
<p> </p>
不安全的 HTML
默认情况下,Zendesk 将以下 HTML 元素视为不安全元素。
applet, button, embed, form, input, object, script, textarea, style
处理文章中的不安全 HTML
对于文章,源代码编辑器不会移除不安全的 HTML 元素或不受支持的 HTML 属性。相反,它们被排除在用于呈现帮助中心文章的 HTTP 响应中。因此,文章可能无法如预期呈现。
允许文章中出现不安全的 HTML
您可以覆盖默认设置,以便在帮助中心文章中允许不安全的 HTML。
警告:进行此更改后,当用户在浏览器中打开文章时,可能会执行恶意代码。
在 HTTP 响应中允许不安全的 HTML
- 在 Guide 中,单击侧栏中的设置图标 ()。
- 在“ 安全”下,选择“ 显示不安全内容 ”选项。
- 单击更新。
处理内容块中的不安全 HTML
对于内容块,源代码编辑器会移除不安全的 HTML 元素和不受支持的属性。不安全元素内的内容放置在 p
元素,如 未知 HTML中所述。
未知 HTML
不受支持 的 HTML 元素将被视为未知。根据您是在编辑内容块还是帮助中心文章,处理不受支持的 HTML 的方式不同。
如果您正在编辑内容块,HTML 块将识别不受支持的内容,并将其包装在 HTML 块中。您可以在内容块编辑器中单击 HTML 块,以打开仅显示该块代码的源代码编辑器。您可以使用此聚焦视图来操作选定内容的 HTML,而无需滚动查看整个内容块的源代码。请参阅使用 HTML 块编辑内容块中的代码。
mytag
元素。<mytag>Hello world!</mytag>
在用于呈现帮助中心的 HTTP 响应中, mytag
元素已移除。而是将其内容放在 p
元素。
<p>Hello world!</p>
设置帮助文章中的 HTML 样式
在可能的情况下,Zendesk 建议 class
属性和相关 CSS 类,以便在帮助中心文章中设置 HTML 的样式。CSS 类应在帮助中心主题中定义。有关更多信息,请参阅自定义帮助中心主题。
为帮助中心主题创建 CSS 规则时,避免使用嵌套选择器,例如 div.container > p > img
。此类规则难以维护,并且可能针对非预期元素。而是使用直接设置类样式的选择器,例如 .container-image
。然后使用 class
元素。例如:
避免使用 style
属性以将内联样式应用到 HTML 元素。内联样式难以维护,并可能导致样式不一致。
翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性
如对翻译准确性有任何疑问,请以文章的英语版本为准。