自适应您的内容

为不同的用户定制您的内容。

设置好你的验证方法后,你将能够使用这些数据为不同用户调整你站点中的内容。

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

使用条件编辑器

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

示例

你通过用户传递给 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。

最后更新于

这有帮助吗?