我們知識庫的一大特色，就是能針對不同作業系統（Windows、macOS、Linux）和 Firefox 版本顯示客製化的說明。舉例來說，我們可以設定某篇說明文章的特定段落「for」（僅供）Windows 使用者觀看，而 Mac 和 Linux 使用者則不會看到。這項功能的設計是為了在背景中無形地運作。當有人開啟說明文章時，我們會自動偵測他們使用的作業系統和 Firefox 版本，並顯示對應的說明。本文將詳細介紹如何在知識庫文章中使用 {for} 標記。

如何切換不同作業系統或 Firefox 版本的說明

為了跟隨本文中的範例，您需要將 Customize this article 選擇器切換到不同的作業系統和 Firefox 版本。此選擇器位於文章右側面板的 Editing Tools（編輯工具）下方。

基本語法與行為

作業系統

以下是顯示一張圖片給 Windows 11 使用者的語法：

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

• 將選擇器變更為 Windows 11 以查看圖片：

  

雖然沒有單獨的 Windows 選擇器，但您可以編寫適用於所有 Windows 版本的說明：

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

• 將選擇器變更為 Windows XP、Windows 7/Vista、Windows 8、Windows 10 或 Windows 11 以查看圖片：

  

Firefox 版本

以下是顯示內容給 Firefox 158 及以上版本 的語法：

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

• 將選擇器變更為 Firefox 158 或更高版本以查看圖片：

  

僅為單一 Firefox 版本顯示說明

若要 僅為 Firefox 158 顯示說明，請使用「=」運算子：

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

• 現在，只有當您將選擇器變更為 Firefox 158 時，圖片才會顯示：

  

結合作業系統與 Firefox 版本

您可以透過逗號分隔來同時指定作業系統和 Firefox 版本：

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

• 將選擇器變更為 Windows 和 Firefox 158 或更高版本以查看圖片：

  

一個更複雜、帶有隱含「for」的情況可以這樣寫：

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

• 將選擇器變更為 Mac 或 Windows 10 或 Windows 11，以及 Firefox 153 或 Firefox 158 及以上版本以查看圖片：

  

否定條件

您可以在條件前加上 not 來否定該條件。只有當條件為假時，否定的條件才為真。例如，條件

not fx158

在 Firefox 版本小於 158 時為真。

利用 {for} 標籤進行進階版本控制

隨著 Firefox 頻繁的更新和功能發布，for 標籤在目標內容策劃中扮演著關鍵角色，使我們能夠根據使用者的特定 Firefox 版本提供相關資訊。這些標籤的主要應用包括：

• 為 Nightly 和 Beta 使用者提供搶先體驗： 它讓我們能向使用 Nightly 和 Beta 管道的使用者展示即將推出的功能或變更，讓他們預先了解可能發現的新內容。這確保了我們最投入和技術能力最強的使用者可以在更廣泛的社群之前開始探索新功能。
• 在發布前進行在地化： for 標籤讓我們能在新版本公開發布前，就先發布對應的內容。這使得我們的在地化社群可以提早準備翻譯，確保新版本在正式管道上線時，就能立即提供多語言支援。
• 避免在一般使用者中造成混淆： 透過使用 for 標籤，我們策略性地避免讓一般使用者接觸到過早的資訊，從而防止他們對當前 Firefox 版本中可用的功能產生混淆。

內容何時顯示

正式來說，只有在同時滿足以下兩個條件時，{for} 和 {/for} 之間的標記才會顯示：

• {for} 沒有作業系統（OS）條件，或者它至少有一個 OS 條件對於使用者正在執行（或手動選取）的作業系統為真。
• {for} 沒有 Firefox 版本條件，或者它至少有一個 Firefox 版本條件對於使用者正在執行（或手動選取）的 Firefox 版本為真。

否則，{for}…{/for} 的內容將不會顯示。

其他一些注意事項：

• 逗號後的空格是可選的。
• {for} 和其他 wiki 標記在文章搜尋摘要中無效。
• 被 {for} 區塊隱藏的標題不會出現在頁面的目錄中。如果使用者透過手動選取正確的作業系統／瀏覽器組合使其顯示，目錄條目會立即出現。

作業系統與產品縮寫

以下是可與 {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 = the Firefox（桌面版）版本，例如 fx156、fx157、fx158 等。
• mN，其中 N = the Firefox for Android（行動版）版本，例如 m156、m157、m158 等。
• iosN，其中 N = the Firefox for iOS（行動版）版本，例如 ios156、ios157、ios158 等。
• tbN，其中 N = the Thunderbird 版本，例如 tb156、tb157、tb158 等。

您必須在 Firefox 支援文章中使用 fxN，在 Firefox for Android 支援文章中使用 mN，在 Firefox for iOS 支援文章中使用 iosN，在 Thunderbird 支援文章中使用 tbN。

行內與區塊級情境

{for} 可以在行內（inline）和區塊級（block-level）情境中使用（以 HTML 的意義來說）。行內形式在處理一行文字時生效：

這是{for win}行內用法{/for}。

區塊形式用於包覆整個段落、有序清單、標題等。唯一的注意事項是，使用區塊形式時，{for} 和 {/for} 應各自獨佔一行。否則，它可能會被視為相鄰段落的一部分，並產生意想不到的結果。

{for win}

這是區塊級。

*一

*二

{/for}

在文章中使用 {for} 的最佳實踐

在為不同作業系統撰寫說明時，最好為每個作業系統／Firefox 版本撰寫完整的句子和段落，即使這意味著會重複內容。這使得文章更容易理解、維護和在地化。例如，當需要移除針對 Firefox 152 及以下版本的特定說明時，可以直接刪除這些區塊，而無需試圖從一個更大的區塊中將它們剝離出來。

• 使用 {for} 的錯誤方式：

  #{for not fx158}{for win,linux}At the top of the Firefox window{/for}{for mac}On the Menu bar{/for}, click the {/for}{for fx158}Click the menu button, go over to the {menu History} menu{/for}{for mac,not fx158}{menu Tools} menu{/for}{for win,linux,not fx158} menu button, go over to the {menu History} menu{/for} and select {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 及以上版本視為三組不同的說明。這種情況很常見，但隨著我們每四周更新一次 Firefox，我們將在後續版本中看到越來越多的變更。它們會像這樣：

  {for not fx157}

  #舊的說明。

  {/for}

  {for =fx157,=fx158}

  #新的說明。

  {/for}

  {for fx159}

  #最新的說明。

  {/for}

完整的知識庫指南

請見 更多關於知識庫貢獻的指南。