What's my plan?
Suite Team, Growth, Professional, Enterprise, or Enterprise Plus
Support with Guide Professional or Enterprise

源代码编辑器使您可以编辑帮助中心的文章和内容块的 HTML 源代码。这使您可以以标准所见即所得编辑器无法实现的方式自定义帮助中心内容并设置其样式。

为了确保您的帮助中心安全并提供最佳的终端用户体验,Zendesk 限制了您在文章和内容块中可以使用的 HTML。
注意:有关受支持 HTML 元素的列表,请参阅 帮助中心文章支持的 HTML。
本文章涵盖以下主题:
  • 编辑文章的源代码
  • 清理文章源代码
  • 编辑源代码时的重要注意事项
    • 空 HTML 容器元素
    • 不安全的 HTML
    • 未知 HTML
    • 设置帮助文章中的 HTML 样式

编辑文章的源代码

您可以使用文章源代码编辑器编辑文章的 HTML,从而自定义帮助中心文章。

编辑文章源代码
  1. 在 帮助中心 或 知识管理中,创建或编辑文章或内容块。
  2. 在文章或内容块中,单击源代码图标 ()。
  3. 在源代码编辑器中,创建或编辑您要使用的源代码。请参阅 帮助中心文章, 了解受支持元素的列表。

  4. 单击 应用 保存编辑并关闭源代码视图。

清理文章源代码中的样式

当您将 HTML 页面的内容复制粘贴到帮助文章中时,可能会带来不需要的样式,从而使文章源代码变得杂乱无章,并影响帮助中心的一致性。您可以使用源代码编辑器中的清理样式按钮,去除对文章编辑器工作不必要的内联样式。清除样式按钮不会影响 CSS 类 或 主题,也不会影响文章编辑器所需的内联样式(例如,前景和背景字体,以及表格单元格的高度和宽度)。

清理文章源代码
  1. 在帮助中心或 知识管理中,创建或编辑文章或内容块。
  2. 在文章或内容块中,单击源代码图标 ()。

    源代码编辑器随即打开,显示所有代码和内联样式。

  3. 在源代码编辑器中,单击 清理样式。

    不受支持的内联样式将从源代码视图中移除。

  4. 单击 应用 保存编辑并关闭源代码视图。
  5. 单击 保存 以保存更改。

编辑源代码时的重要注意事项

空 HTML 容器元素

Zendesk 会自动移除大多数空容器元素,例如 i 或 span.这些元素通常必须包含要呈现的内容。Zendesk 不会移除空白 p 标签。取而代之的是,Zendesk 会插入   作为元素的内容。例如:

<p>&nbsp;</p>

不安全的 HTML

默认情况下,Zendesk 认为以下 HTML 元素是不安全的。

不安全的 HTML 元素
applet, button, embed, form, input, object, script, textarea, style

处理文章中不安全的 HTML

对于文章,源代码编辑器不会移除不安全的 HTML 元素或不受支持的 HTML 属性。相反,它们被排除在用于呈现帮助中心文章的 HTTP 响应中。因此,文章可能无法如预期呈现。

允许文章中出现不安全的 HTML

您可以覆盖默认设置,允许帮助中心文章中出现不安全的 HTML。

警告:进行此更改将允许用户在浏览器中打开文章时潜在的恶意代码被执行。

允许 HTTP 响应中包含不安全的 HTML

  1. 在知识管理员中,单击侧栏中的设置图标 ()。
  2. 在 安全下,选择 显示不安全内容 选项。
  3. 单击更新。

处理内容块中的不安全 HTML

对于内容块,源代码编辑器会移除不安全的 HTML 元素和不受支持的属性。不安全元素内的内容将放置在 p 元素如 未知的 HTML中所述。

未知 HTML

不受支持的 HTML 元素将被视为未知。根据您编辑的是内容块还是帮助中心文章,对不受支持的 HTML 的处理方式有所不同。

如果您正在编辑内容块,HTML 块会识别不受支持的内容,并将其包装在 HTML 块中。您可以单击内容块编辑器中的 HTML 块以打开仅显示该块代码的源代码编辑器。您可以使用此聚焦视图来操作选定内容的 HTML,而无需滚动查看整个内容块的源代码。请参阅使用 HTML 块编辑内容块中的代码。

如果您尝试在文章的源代码中使用不受支持的 HTML,Zendesk 会移除所有未知标签,并将标签内容放在 ap 元素中。例如,以下 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.然后使用 直接将该类添加到受影响的 HTML 元素 class 元素。例如:<img class="container-image" ...>

避免使用 style 属性以将内联样式应用到 HTML 元素。内联样式难以维护,并可能导致样式不一致。

翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性

如对翻译准确性有任何疑问,请以文章的英语版本为准。

由 Zendesk 提供技术支持