调整你的内容

为不同用户定制你的内容

设置好身份验证方法后,您就可以使用这些数据为网站中的不同用户调整内容。

您可以调整和个性化文档的许多部分,包括:

使用条件编辑器

条件编辑器是您设置显示或隐藏页面、变体或部分条件的地方。打开条件编辑器后,您就可以将条件编写为一个 表达式 ,该表达式将根据来自您网站访问者的数据运行。

示例

您传递给 GitBook 的用户数据会附加到一个名为 visitor.claims.

让我们看一个示例:如果我们想编写一个条件语句来 仅向属于测试版计划的用户显示页面 ,您可以这样定义。

上面的表达式表示,任何匹配此声明的用户(即 isBetaUsertrue 在用户声明中),都可以看到并访问该页面。任何不匹配此声明的用户(包括未设置任何声明的访问者)都无法看到或访问该页面。

条件编辑器还内置了自动补全功能,它会根据在您网站上先前访问者中发现的声明或属性提供建议,帮助您为页面、变体或部分编写条件语句。

当您使用自动补全时,您会注意到 变量 也可供使用。您可以将已定义的变量与来自用户数据的声明组合起来编写条件表达式。例如,您可以:

  1. 为您的产品最新版本设置一个变量

  2. 然后,配置一个声明,显示访问您文档的访客正在使用您产品的哪个版本

  3. 最后,编写一个表达式,使其仅在用户使用您文档的最新版本时显示某些页面

只要写法符合有效的 Javascript,您就可以编写许多不同类型的表达式。例如,您可以在条件编辑器中组合多个声明,并使用 && 或者 || 运算符。您可以在此处阅读更多关于运算符的内容 这里arrow-up-right.

使用分段进行测试

分段表示可供您配置以测试条件的模拟用户数据。

例如,您可以设置一个分段,代表企业计划中的开发者,或者免费计划中的登录用户,然后查看哪些页面会对他们可见。

您可以在这里阅读更多有关设置和使用分段的内容。

条件页面

要为某个页面启动条件编辑器,请前往该页面旁边的操作菜单 The Actions menu icon in GitBook ,然后点击 添加条件。 您也可以从 页面选项.

如果页面旁边有页面条件图标,您就可以看到空间中哪些页面设置了条件 The Page condition icon in GitBook

条件变体

要为某个变体启动条件编辑器,请前往该变体旁边的操作菜单 The Actions menu icon in GitBook ,然后点击 添加条件.

如果变体旁边有页面条件图标,您就可以看到文档中哪些变体设置了条件 The Page condition icon in GitBook

条件部分

要为某个部分启动条件编辑器,请前往该部分旁边的操作菜单 The Actions menu icon in GitBook ,然后点击 添加条件.

如果部分旁边有页面条件图标,您就可以看到文档中哪些部分设置了条件 The Page condition icon in GitBook

条件页面页眉链接

要为某个页面页眉链接启动条件编辑器,请前往该链接旁边的操作菜单 The Actions menu icon in GitBook ,然后点击 添加条件.

如果该部分旁边有页面条件图标,您就可以看到文档中哪些链接设置了条件 The Page condition icon in GitBook

行内表达式

除了控制内容的可见性之外,您还可以像使用页面和空间变量一样,使用 表达式直接引用声明。

要使用表达式直接引用声明,请在编辑器中输入 / ,然后选择 表达式。声明在表达式编辑器中将作为 visitor .

上的属性可访问

在 GitBook 中设置的条件会通过 Git Sync 同步,并显示在同步后的 Markdown 页面中。这意味着,即使设置了可见性的块和页面,在同步后的仓库中仍然可见。

通过声明传递的数据绝不会在 Markdown 中可见,并会安全地传递给 GitBook。

最后更新于

这有帮助吗?