功能标记

通过功能标记提供方将访客数据传入你的文档

将自适应内容与功能标志一起使用需要向你的应用程序添加代码。

目前，GitBook helper 仅支持基于 React 的设置。

GitBook 为诸如以下流行的功能标志服务提供商提供辅助函数和集成： LaunchDarkly 并 Reflag.

这使你能够在用户阅读文档时读取他们在产品中可访问的功能标志。如果你需要为仅对特定人群开放的功能展示文档，这将非常有用。

LaunchDarkly

LaunchDarkly 允许你通过以下方式将功能标志访问作为声明发送： launchdarkly-react-client-sdk 以及 GitBook 的 @gitbook/adaptive 包。

如果你已经在产品中使用 LaunchDarkly 功能标志，那么很可能你已经配置了这个包。

要将这些功能标志作为声明传递给 GitBook，请按以下步骤操作：

1

安装 LaunchDarkly 集成

要开始使用，你首先需要 安装 LaunchDarkly 集成 到你的 GitBook 站点中。

2

设置你的项目和访问密钥

将你的项目密钥和服务访问令牌从你的 LaunchDarkly 设置 添加到该集成的配置中。

3

将 GitBook helper 安装并添加到你的应用程序中

在设置好 LaunchDarkly 集成后，你需要在应用程序中安装 GitBook 自适应内容 helper。

npm install @gitbook/adaptive

4

配置你的应用程序

你需要将 withLaunchDarkly helper 与 LaunchDarkly React SDK 一起使用，以将上下文传递给 GitBook。

import { render } from 'react-dom';
import { withLaunchDarkly } from '@gitbook/adaptive';
import { asyncWithLDProvider, useLDClient } from 'launchdarkly-react-client-sdk';
import MyApplication from './MyApplication';

function PassFeatureFlagsToGitBookSite() {
    const ldClient = useLDClient();
    React.useEffect(() => {
        if (!ldClient) {
            return;
        }
        return withLaunchDarkly(ldClient);
    }, [ldClient]);
    return null;
}
(async () => {
    const LDProvider = await asyncWithLDProvider({
        clientSideID: 'client-side-id-123abc',
        context: {
            kind: 'user',
            key: 'user-key-123abc',
            name: 'Sandy Smith',
            email: '[e-mail]'
        },
        options: { /* ... */ }
    });
    render(
        <LDProvider>
            <PassFeatureFlagsToGitBookSite />
            <MyApplication />
        </LDProvider>,
        document.getElementById('reactDiv'),
    );
})();

5

检查你的访客 schema

一项 访客 schema 是必需的，这样你的声明才能在已发布站点中被读取。安装并配置 LaunchDarkly 集成应会自动为你设置访客 schema。

6

个性化你的内容

设置好访客 schema 后，你就可以使用用户可访问的功能标志，为访问你站点的用户定制文档体验。

LaunchDarkly 中可用的任何功能标志值都会作为访客 schema 的一部分，显示在 visitor.claims.unsigned.launchdarkly 对象下。阅读更多关于未签名声明的信息 这里.

进入 调整你的内容 以了解更多关于为用户个性化文档的信息。

Reflag

Reflag 允许你通过以下方式将功能标志访问作为声明发送： @reflag/react-sdk 以及 GitBook 的 @gitbook/adaptive 包。

如果你已经在产品中使用 Reflag 功能标志，那么很可能你已经配置了这个包。

要将这些功能标志作为声明传递给 GitBook，请按以下步骤操作：

1

安装 Reflag 集成

要开始使用，你首先需要 安装 Reflag 集成 到你的 GitBook 站点中。

2

设置你的密钥

将你的密钥从你的 Reflag 设置 添加到该集成的配置中。

3

将 GitBook helper 安装到你的应用程序中

在设置好 Reflag 集成后，你需要在应用程序中安装 GitBook 自适应内容 helper。

npm install @gitbook/adaptive

4

配置你的应用程序

你需要将 withReflag helper 与 Reflag React SDK 一起使用，以将上下文传递给 GitBook。

import { withReflag } from '@gitbook/adaptive';
import { ReflagProvider, useClient } from '@reflag/react-sdk';
import MyApplication from './MyApplication';

function PassFeatureFlagsToGitBookSite() {
    const client = useClient();
    React.useEffect(() => {
        if (!client) {
            return;
        }
        return withReflag(client);
    }, [client]);
    return null;
}
export function Application() {
    const currentUser = useLoggedInUser();
    const appConfig = useAppConfig();
    return (
        <ReflagProvider
            publishableKey={appConfig.reflagCom.publishableKey}
            user={{
                id: currentUser.uid,
                email: currentUser.email ?? undefined,
                name: currentUser.displayName ?? '',
            }}
            company={{
                id: currentUser.company.id,
            }}
        >
            <PassFeatureFlagsToGitBookSite />
            <MyApplication />
        </ReflagProvider>
    );
}

5

检查你的访客 schema

一项 访客 schema 是必需的，这样你的声明才能在已发布站点中被读取。安装并配置 Reflag 集成应会自动为你设置访客 schema。

6

个性化你的内容

设置好访客 schema 后，你就可以使用用户可访问的功能标志，为访问你站点的用户定制文档体验。

Reflag 中可用的任何功能标志值都会作为访客 schema 的一部分，显示在 visitor.claims.unsigned.reflag 对象下。阅读更多关于未签名声明的信息 这里.

进入 调整你的内容 以了解更多关于为用户个性化文档的信息。

功能标志值是在客户端计算的，因此避免使用此方法传递敏感或对安全至关重要的数据。