自定义嵌入体验

通过设置欢迎信息、操作等来自定义将文档嵌入到产品或应用中的体验

在 将 Docs Embed 添加到您的网站或应用后，您可以通过在侧边栏添加可执行按钮、向用户提示上下文问题的建议等方式，进一步自定义体验。

自定义按钮（独立 仅限）

使用 独立脚本标签实现时，您可以自定义用于启动嵌入小部件的按钮标签和图标。

此按钮自定义选项仅在使用 独立脚本标签实现时可用。对于 React 或 Node.js/NPM 包 实现，您需要创建自己的按钮来启动嵌入。

window.GitBook("configure", {
  button: {
    label: "询问",
    icon: "assistant", // 'assistant' | 'sparkle' | 'help' | 'book'
  },
});

可用图标选项：

• assistant - 助手图标（默认）

• sparkle - 闪光图标

• help - 帮助/问号图标

• book - 书籍图标

添加操作

向嵌入添加操作可让您在 UI 中为用户提供额外的操作。每个操作由标签、图标（来自 Font Awesome）和一个 onClick 操作组成，当用户点击该操作时运行。您添加的任何操作将与选项卡一起显示在侧边栏中。操作可以控制 Docs Embed 本身或执行您想要的任何代码。

window.GitBook("configure", {
  actions: [
    {
      label: "联系支持",
      icon: "circle-question",
      onClick: () => {
        window.open("https://support.example.com", "_blank");
      },
    },
    {
      label: "文档",
      icon: "book",
      onClick: () => {
        window.open("https://docs.example.com", "_blank");
      },
    },
  ],
});

添加建议

您可以向助手选项卡添加建议，这些建议将在助手加载时以可点击的提示形式显示给用户使用。

window.GitBook("configure", {
  suggestions: [
    "帮我开始使用我的新账户",
    "我如何重置我的密码？",
    "你们的定价方案有哪些？",
  ],
});

添加欢迎语

自定义在助手选项卡中显示的欢迎消息：

window.GitBook("configure", {
  greeting: {
    title: "欢迎！",
    subtitle: "我今天可以如何帮助您？",
  },
});

配置选项卡

覆盖显示哪些选项卡。默认情况下，嵌入会根据您网站的配置显示选项卡。

window.GitBook("configure", {
  tabs: ["assistant", "docs"], // 同时显示两个选项卡
  // tabs: ['assistant'], // 仅显示助手选项卡
  // tabs: ['docs'], // 仅显示文档选项卡
});