変数と式

ページやスペースで参照できる再利用可能な変数を作成する

変数を使うと、再利用可能なテキストを作成でき、適応コンテンツの条件内で条件付きに参照できます。 および 適応コンテンツの条件.

同じ名前、フレーズ、またはバージョン番号をコンテンツ内で何度も繰り返す場合、次のものを作成できます。 変数 それらすべてのインスタンスを同期し正確に保つのに役立ちます — 更新が必要になった場合や、複雑で誤入力されやすい場合に便利です。

変数は単一ページまたは単一スペースにスコープを限定して作成できます。

新しい変数を作成

新しい変数を作成するには、編集中の開いている ライブラリ の目次でクリックします 変更リクエスト。次に、クリックします コラボレーションに招待.

上部のトグルを使用して、現在のページにスコープされた変数、または現在のスペース内のすべてのページにスコープされた変数の表示と作成を切り替えられます。

をクリックすると 変数を作成 モーダルが起動し、そこで変数に名前と値を付けることができます。

クリック 変数を追加 して変数を保存します。

A GitBook screenshot showing the Add variables screen. The variable Name box has been filled with the text ‘latest_version’ and the Value box has been filled with the text ‘v3.04.1’
変数は単一ページまたはスペース全体に追加できます。変数の値を更新すると、その変数のすべてのインスタンスが更新されます。

変数名は文字で始める必要があり、文字、数字、アンダースコアを含めることができます。

コンテンツで変数を使用する

変数は表現(expression)の中で参照および使用できます — これはインラインでコンテンツに挿入できます。式を挿入した後、それをダブルクリックすると式エディタが開きます。

ページの下で定義された変数は、以下でアクセスできます page.vars オブジェクト。同様に、スペース全体で定義された変数は、以下でアクセスできます space.vars オブジェクトとして定義する必要があります。

A GitBook screenshot showing an expression block within the editor. The expression editor is open below it and the ‘space.vars.latest_version’ variable has been selected
式内でコンテンツに変数を追加できます。式エディタは、必要な変数を見つけるのに役立つオートコンプリートオプションを提供します。

変数を更新する

変更リクエスト内にいる間はいつでも変数を更新できます。値を更新すると、それを参照する任意の式ブロック全体で値が更新されます。変更された変数は、変更リクエストがマージされると公開サイトに反映されます。

最終更新

役に立ちましたか?