ナレッジベースの優れた機能の一つに、オペレーティングシステム (Windows、macOS、Linux) や Firefox のバージョンに合わせてカスタマイズされた手順を表示する機能があります。例えば、ヘルプ記事のあるセクションを Windows ユーザー「向け」とし、Mac や Linux ユーザーには表示しないようにできます。この機能は、ユーザーが意識することなく動作するように設計されています。誰かがヘルプ記事を開くと、使用しているオペレーティングシステムと Firefox のバージョンが自動的に検出され、適切な手順が表示されます。この記事では、ナレッジベースの記事で {for} マークアップを使用する方法の詳細を説明します。

異なるオペレーティングシステムや Firefox のバージョンに手順を切り替える方法

この記事の例に従うには、この記事をカスタマイズ セレクターを異なるオペレーティングシステムと Firefox のバージョンに切り替える必要があります。セレクターは記事の右パネルの 編集ツール の下にあります。

基本的な構文と動作

オペレーティングシステム

Windows 11 向けの画像を表示する構文は次のとおりです:

{for win11}[[Image:Windows11 Logo]]{/for}

Windows セレクターは存在しませんが、すべての Windows バージョンに適用される手順を書くことができます:

{for win}[[Image:Image:vista.jpg]]{/for}

Firefox のバージョン

Firefox 158 以降 向けに何かを表示する構文は次のとおりです:

{for fx158}[[Image:Firefox Quantum Logo]]{/for}

Firefox の 1 つのバージョンのみに手順を表示する

手順を Firefox 158 のみ に表示するには、「=」演算子を使用します:

{for =fx158}[[Image:Firefox Quantum Logo]]{/for}

• これで、セレクターを Firefox 158 に変更したときにのみ画像が表示されます。

オペレーティングシステムと Firefox のバージョンの組み合わせ

オペレーティングシステムと Firefox のバージョンは、コンマで区切って指定できます:

{for win,fx158}[[Image:Windows11 Logo]][[Image:Quantum Logo]]{/for}

暗黙の「for」を含む、より複雑な状況は次のように書くことができます:

{for mac, win10, win11, =fx153, fx158}[[Image:Windows11 Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for}

条件の否定

条件の前に not という単語を付けることで、条件を否定できます。否定された条件は、元の条件が偽である場合にのみ真となります。例えば、条件

not fx158

は、Firefox のバージョンが 158 未満の場合に真となります。

{for} タグを活用した高度なバージョン管理

Firefox の頻繁な更新と機能リリースに伴い、「for」タグは、特定の Firefox バージョンに基づいた関連情報をユーザーに提供するための、的を絞ったコンテンツ管理において重要な役割を果たします。これらのタグの主な用途は次のとおりです:

• Nightly および Beta ユーザーへの早期アクセス: これにより、Nightly および Beta チャンネルを使用しているユーザーに、今後の機能や変更点を提示し、何が追加されるかを事前に知らせることができます。これにより、最も熱心で技術的なユーザーが、より広範なコミュニティに先駆けて新しい機能を試し始めることができます。
• ローンチ前のローカライゼーション: 「for」タグを使用すると、一般公開前に今後のバージョンのコンテンツを公開できます。これにより、ローカライゼーションコミュニティが早期に翻訳を準備でき、新しいバージョンが製品チャンネルで公開された瞬間に多言語サポートを保証できます。
• 一般ユーザーの混乱を避ける: 「for」タグを使用することで、一般ユーザーに時期尚早な情報を公開することを戦略的に避け、現在の Firefox バージョンで利用可能な機能についての混乱を防ぎます。

コンテンツが表示されるとき

正式には、{for} と {/for} の間のマークアップは、次の両方の条件が満たされた場合に 表示 されます:

• {for} にオペレーティングシステム (OS) の条件がないか、ユーザーが使用している (または手動で選択した) OS に関して真となる OS 条件が少なくとも 1 つある。
• {for} に Firefox のバージョンの条件がないか、ユーザーが使用している (または手動で選択した) Firefox のバージョンに関して真となる Firefox バージョンの条件が少なくとも 1 つある。

それ以外の場合、{for}…{/for} のコンテンツは表示されません。

その他、注意すべき点がいくつかあります:

• コンマの後のスペースは任意です。
• {for} やその他の Wiki マークアップは、記事の検索概要では機能しません。
• {for} ブロックによって非表示にされた見出しは、ページの目次には表示されません。ユーザーが適切な OS とブラウザーの組み合わせを手動で選択して表示させると、目次のエントリーが即座に表示されます。

オペレーティングシステムと製品の略語

これらは、{for} で使用できるオペレーティングシステムと製品の略語です:

• win (Windows)
• winxp (Windows XP/2000/Server 2003)
• win7 (Windows 7/Vista/Server 2008)
• win8 (Windows 8/8.1/Server 2012)
• win10 (Windows 10)
• win11 (Windows 11)
• mac (macOS)
• linux (Linux)
• fxN (N は Firefox (デスクトップ) のバージョン。例: fx156, fx157, fx158 など)
• mN (N は Firefox for Android (モバイル) のバージョン。例: m156, m157, m158 など)
• iosN (N は Firefox for iOS (モバイル) のバージョン。例: ios156, ios157, ios158 など)
• tbN (N は Thunderbird のバージョン。例: tb156, tb157, tb158 など)

Firefox のサポート記事では fxN、Firefox for Android のサポート記事では mN、Firefox for iOS のサポート記事では iosN、Thunderbird のサポート記事では tbN を使用する必要があります。

インラインとブロックレベルのコンテキスト

{for} は、インラインとブロックレベルの両方のコンテキスト (HTML の意味で) で使用できます。インライン形式は、テキストの行内で作業するときに有効です:

これは {for win}インラインでの使用例{/for} です。

ブロック形式は、段落全体、順序付きリスト、見出しなどを囲むために使用されます。唯一の注意点は、ブロック形式を使用する場合、{for} と {/for} はそれぞれ別の行に記述する必要があることです。そうしないと、隣接する段落の一部と見なされ、予期しない結果が生じる可能性があります。

{for win}

これはブロックレベルです。

*1

*2

{/for}

記事で を使用するためのベストプラクティス

異なるオペレーティングシステムの手順を作成する場合、たとえ重複する部分があっても、OS や Firefox のバージョンごとに完全な文と段落で記述するのが最善です。 これにより、記事が理解しやすく、保守やローカライズも容易になります。例えば、Firefox 152 以前の特定の手順を削除する時期が来たとき、大きなセクションからそれらを切り出そうとするのではなく、そのセクション全体を削除するだけで済みます。

• {for} の 間違った使い方:

  #{for not fx158}{for win,linux}Firefox ウィンドウ上部の{/for}{for mac}メニューバーの{/for}、{/for}{for fx158}メニューボタン をクリックし、{menu History} メニューへ進み{/for}{for mac,not fx158}{menu Tools} メニュー{/for}{for win,linux,not fx158} メニューボタン、{menu History} メニューへ進み{/for}、{menu Clear Recent History…} を選択します{/for}

• {for} の 正しい使い方:

  {for not fx158}

  #{for win,linux}Firefox ウィンドウ上部のメニューボタンをクリックし、{menu History} メニューへ進んで {menu Clear Recent History…} を選択します{/for}{for mac}メニューバーの {menu Tools} メニューをクリックし、{menu Clear Recent History…} を選択します{/for}

  {/for}

  {for fx158}

  #メニューボタン をクリックし、{menu History} メニューへ進んで {menu Clear Recent History…}

  {/for}

• 次の例では、Firefox 156 以前、Firefox 157/158、Firefox 159 以降を 3 つの異なる手順のセットとして扱います。これはよくあるケースですが、Firefox は 4 週間ごとに変更されるため、後のバージョンでより多くの変更が見られるようになります。それらは次のようになります:

  {for not fx157}

  #古い手順。

  {/for}

  {for =fx157,=fx158}

  #新しい手順。

  {/for}

  {for fx159}

  #さらに新しい手順。

  {/for}

ナレッジベースの完全なガイドライン

ナレッジベースへの貢献に関する詳しいガイドライン をご覧ください。