変数と式

ページやセクションで参照できる再利用可能な変数を作成します

変数を使うと、条件に応じて参照できる再利用可能なテキストを作成できます 式 、 アダプティブコンテンツの条件.

コンテンツ内で同じ名前、フレーズ、またはバージョン番号を何度も繰り返す場合は、 変数 を作成して、それらのすべてを同期した正確な状態に保つのに役立てられます。更新が必要な場合や、複雑で টাইポが起こりやすい場合に便利です。

単一ページ、または単一セクションにスコープを限定した変数を作成できます。

新しい変数を作成

新しい変数を作成するには、 ライブラリ 編集中の開いているドキュメントの目次で 変更リクエスト。次に、 変数.

上部のトグルを使って、現在いるページにスコープを限定した変数と、現在のセクション内のすべてのページにスコープを限定した変数を表示・作成できます。

をクリックすると 変数を作成 するためのモーダルが開き、変数の名前と値を入力できます。

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

変数は、単一ページにもセクション全体にも追加できます。変数の値を更新すると、その変数のすべてのインスタンスが更新されます。

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

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

変数は、 式 の中で参照して使用できます。これはインラインでコンテンツに挿入できます。式を挿入したら、ダブルクリックして式エディタを開きます。

式は、ドキュメントのページ本文でのみ使用できます。ページタイトルやページのメタデータでは機能しません。

ページ下に定義した変数は、 page.vars オブジェクトから参照できます。同様に、セクション全体に定義した変数は、 space.vars オブジェクト。

から参照できます。式では、セクションスコープの変数は space.vars の下にあり、— GitBook API ではセクションを space オブジェクトとして表します。

式の中でコンテンツに変数を追加できます。式エディタには、必要な変数を見つけるのに役立つオートコンプリート候補があります。

変数を更新する

変更リクエストの途中であれば、いつでも変数を更新できます。値を更新すると、それを参照しているすべての式ブロックで値が更新されます。変更された変数は、変更リクエストがマージされると、公開済みのサイトすべてに反映されます。