カスタム変数 custom-variables

リクエストおよびビネット：:Modifier 文字列のクエリ部分には、ユーザー定義の変数を含めることができます。

$ name = value

name – 変数名。 $ を除く、英数字、安全文字の任意の組み合わせで構成される場合があります。

value – 変数を設定する値（文字列）。

変数は、上記の構文を使用して、他のサーバーコマンドと同様に定義されます。 変数は、参照する前に定義する必要があります。 vignette::Modifier で定義された変数は、URL リクエストで参照できます。逆の場合も同じです。

変数は、コマンド値の任意の場所に変数名（先頭と末尾の $ で囲まれた名前）を埋め込むことで参照されます。 例えば、コマンド名の後の = と、後続の & またはリクエストの終わり。 サーバーは、このような $ name$ の発生をそれぞれ string で置き換えます。 コマンド名（コマンドの等号の前）およびリクエストのパス部分で $ name$ が使用されていても、置き換えは行われません。

カスタム変数はネストできません。 string 内の $ name$ に一致する語句は置換されません。 例えば、リクエストフラグメント $var2=apple&$var1=my$var2$tree&text=$var1$ は text=my$var2$tree に解決されます。

$ は予約文字ではありません。それ以外の場合はリクエストで発生する可能性があります。 たとえば、src=my$texture$file.tif は有効なコマンドですが（my$texture$file.tif という名前のマテリアル カタログ エントリまたはテクスチャ ファイルが存在すると仮定）、wid=$number$ は有効ではありません。wid= には数値の引数が必要です。