调整您的内容

为不同用户定制您的内容

在设置好您的身份验证方法后,您将能够使用这些数据为不同用户定制网站内容。

您可以自定义和个性化文档的许多部分,包括:

使用条件编辑器

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

示例

您通过用户传递给 GitBook 的数据附加在一个名为 visitor.claims.

的对象上。如果我们想编写一个条件语句来,下面看一个示例: 仅向属于测试计划的用户显示页面 您可能会定义。

visitor.claims.isBetaUser == true

上面的表达式意味着任何匹配该声明的用户(即 isBetaUsertrue 在用户的声明中)将能够查看和访问该页面。任何不匹配该声明的用户(包括未设置任何声明的访客)将无法查看或访问该页面。

条件编辑器还内置了自动完成,它会建议在以前访问您站点的访客中发现的声明或属性,帮助您为页面、变体或部分构建条件语句。

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

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

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

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

只要用有效的 Javascript 编写,您可以编写许多不同类型的表达式。例如,您可以将多个声明组合到条件编辑器中,通过使用 &&|| 运算符来匹配特定用户。您可以在 这里.

了解有关运算符的更多信息

使用分组进行测试

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

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

您可以在此处阅读有关设置和使用分组的更多信息。

有条件的页面 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 对象上的属性来访问。使用 Git 同步 在 GitBook 中设置的条件会通过 Git 同步进行同步,并出现在同步的 Markdown 页面中。这意味着具有可见性条件的区块和页面在同步到您的仓库后仍然可见。 .

通过声明传递的数据在 Markdown 中永远不可见,且会被安全地传递到 GitBook。

条件编辑器还内置了自动完成,它会建议在以前访问您站点的访客中发现的声明或属性,帮助您为页面、变体或部分构建条件语句。

通过声明传递的数据在 Markdown 中永远不可见,且会被安全地传递到 GitBook。

最后更新于

这有帮助吗?