コンテンツの適応

異なるユーザー向けにコンテンツを調整する

認証方法を設定すると、ユーザごとにサイト内のコンテンツを適応させるためにそのデータを使用できるようになります。

ドキュメントの多くの部分を次のように適応・パーソナライズできます:

条件エディターの使い方

条件エディターは、ページ、バリアント、またはセクションの表示/非表示の条件を設定する場所です。条件エディターを開くと、条件を として記述でき、その式はサイト訪問者からのデータに対して実行されます。

あなたがユーザーから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 Syncとの連携

GitBookで設定された条件はGit Syncを通じて同期され、同期されたMarkdownページに表示されます。つまり、表示条件が設定されたブロックやページは同期されたリポジトリ内でも確認できます。

最終更新

役に立ちましたか?