调整你的内容

为不同用户定制你的内容

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

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

使用条件编辑器

条件编辑器是你为显示或隐藏页面、变体或区块设置条件的地方。打开条件编辑器后,你可以将你的条件写成一个 表达式 ,该表达式会根据来自站点访客的数据运行。

示例

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

与 Git 同步配合使用

在 GitBook 中设置的条件会通过 Git 同步同步,并出现在已同步的 Markdown 页面中。这意味着设置了可见性条件的区块和页面在你的同步仓库中仍然可见。

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

最后更新于

这有帮助吗?