Um dos grandes recursos da nossa Base de Conhecimento é a capacidade de mostrar instruções personalizadas para sistemas operacionais (Windows, macOS, Linux) e versões do Firefox. Podemos dizer, por exemplo, que uma determinada seção de um artigo de ajuda é “para” usuários do Windows e usuários de Mac e Linux não a verão. O recurso foi projetado para funcionar de forma invisível. Quando alguém abre um artigo de ajuda, detectamos automaticamente qual sistema operacional e versão do Firefox a pessoa está usando e mostramos as instruções apropriadas. Este artigo detalha como usar a marcação {for} em artigos da Base de Conhecimento.

Como alternar instruções para diferentes sistemas operacionais ou versões do Firefox

Para seguir o exemplo neste artigo, você terá que mudar o seletor do artigo para diferentes sistemas operacionais e versões do Firefox. Ele está localizado no painel direito do artigo, em Editing Tools.

Sintaxe básica e comportamento

Sistemas operacionais

Esta é a sintaxe para mostrar uma imagem para o Windows 10:

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

• Mude o seletor para Windows 10 para ver a imagem:

  

Apesar de não existir um seletor para Windows, você pode escrever instruções que se aplicam a todas as versões do Windows:

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

• Mude o seletor para Windows XP, Windows 7/Vista, Windows 8, Windows 10 ou Windows 11 para ver a imagem:

  

Versões do Firefox

Esta é a sintaxe para mostrar algo para o Firefox 140 e superior:

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

• Mude o seletor para Firefox 140 ou superior para ver a imagem:

  

Mostrar instruções para apenas uma versão do Firefox

Para mostrar instruções somente para o Firefox 140, use o operador “=”:

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

• Agora a imagem só aparece quando você muda o seletor para Firefox 140:

  

Combinando sistemas operacionais e versões do Firefox

Você pode especificar um sistema operacional e uma versão do Firefox separando-os com uma vírgula:

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

• Mude o seletor para Windows e Firefox 140 ou superior para ver as imagens:

  

Uma situação mais complexa com um “para” implícito pode ser escrita assim:

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

• Mude o seletor para Mac ou Windows 10 ou Windows 11 e Firefox 128 ou Firefox 140 e superior para ver as imagens:

  

Negando condições

Você pode negar uma condição precedendo-a com a palavra not. Uma condição negada é verdadeira se, e somente se, a condição for falsa. Por exemplo, a condição

not fx140

é verdadeira se a versão do Firefox for inferior a 140.

Aproveite as tags {for} para controle avançado de versões

Com atualizações e lançamentos de recursos frequentes no Firefox, as tags for desempenham um papel fundamental na curadoria de conteúdo direcionado, permitindo-nos fornecer informações relevantes aos usuários com base em sua versão específica do Firefox. As principais aplicações dessas tags incluem:

• Acesso antecipado para usuários do Nightly e Beta: Permite-nos apresentar futuros recursos ou alterações aos usuários que estão nos canais Nightly e Beta, dando-lhes um aviso sobre o que podem encontrar. Isso garante que nossos usuários mais engajados e técnicos possam começar a explorar novas funcionalidades antes da comunidade em geral.
• Tradução antes do lançamento: As tags for nos permitem publicar conteúdo para as próximas versões antes de seu lançamento público. Isso permite que nossa comunidade de tradução prepare as traduções com antecedência, garantindo suporte em vários idiomas no momento em que uma nova versão for lançada no canal de produção.
• Evitar confusão entre o público em geral: Usando as tags for, evitamos estrategicamente expor nosso público em geral a informações prematuras, evitando assim confusão sobre o que está atualmente disponível em sua versão atual do Firefox.

Quando o conteúdo é exibido

Formalmente, a marcação entre {for} e {/for} será exibida se ambas as condições a seguir forem atendidas:

• O {for} não tem nenhuma condição de sistema operacional (SO), ou tem pelo menos uma condição de SO que é verdadeira em relação ao SO que o usuário está executando (ou selecionou manualmente).
• O {for} não tem nenhuma condição de versão do Firefox, ou tem pelo menos uma condição de versão do Firefox que é verdadeira em relação à versão do Firefox que o usuário está executando (ou selecionou manualmente).

Caso contrário, o conteúdo de {for}…{/for} não é exibido.

Algumas outras coisas a serem observadas:

• Espaços após as vírgulas são opcionais.
• {for} e outras marcações wiki não funcionam no resumo dos artigos.
• Os títulos que estão escondidos pelos blocos de {for} não aparecem no índice de conteúdo da página. Se o usuário fizer com que esses blocos sejam exibidos, após selecionar manualmente o sistema operacional e a versão do navegador, essas entradas no índice de conteúdo aparecerão automaticamente.

Abreviações de sistema operacional e produto

Estas são as abreviações de sistema operacional e produto disponíveis para uso com {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 onde N = a versão do Firefox (desktop), por exemplo fx115, fx116, fx117, etc.
• mN onde N = a versão do Firefox for Android (mobile), por exemplo m115, m116, m117, etc.
• tbN onde N = a versão do Thunderbird, por exemplo tb91, tb102, tb115, etc.

Você deve usar fxN em artigos de suporte do Firefox, mN em artigos de suporte do Firefox for Android e tbN em artigos de suporte do Thunderbird.

Contextos alinhado e em bloco

{for} pode ser usado tanto alinhado ou em bloco (no sentido HTML). O formato "alinhado" se torna viável ao trabalhar com uma única linha de texto:

Este é o uso {for win}alinhado{/for}.

A forma em bloco é utilizada para incorporar parágrafos inteiros, listas ordenadas, títulos e assim por diante. A única advertência é que, ao usar a forma em bloco, o {for} e {/for} devem cada um estar em uma linha por si só. Caso contrário, pode ser considerado parte de outro parágrafo e produzir resultados indesejáveis.

{for win}

Esta é em nível de bloco.

*Um

*Dois

{/for}

Melhores práticas ao usar {for} em artigos

Ao escrever instruções para diferentes sistemas operacionais, é melhor escrever frases e parágrafos completos para cada versão de SO/Firefox, mesmo que isso signifique duplicar coisas. Isso torna o artigo mais fácil de entender, manter e traduzir. Quando chegar a hora, por exemplo, de remover instruções específicas para o Firefox 140 e versões anteriores, essas seções podem simplesmente ser excluídas, em vez de tentar extraí-las de uma seção maior.

• A maneira errada de usar {for}:

  #{for not fx140}{for win,linux}At the top of the Firefox window{/for}{for mac}On the menu bar{/for}, click on the {/for}{for fx140}Click the menu button, go over to the {menu History} menu{/for}{for winxp,mac,linux,not fx140}{menu Tools} menu{/for}{for win10,win11,not fx140}{menu Firefox} menu, go over to the {menu History} menu{/for} and select {menu Clear Recent History…}

• A maneira certa de usar {for}:

  {for not fx140}

  #{for win10,win11}At the top of the Firefox window, click on the {menu Firefox} menu, go over to the {menu History} menu and select {menu Clear Recent History…}{/for}{for mac}On the menu bar, click on the {menu Tools} menu and select {menu Clear Recent History…}{/for}{for winxp,linux}At the top of the Firefox window, click on the {menu Tools} menu and select {menu Clear Recent History…}{/for}

  {/for}

  {for fx140}

  #Click the menu button, go over to the {menu History} menu and select {menu Clear Recent History…}

  {/for}

• No exemplo a seguir, tratamos o Firefox 140 e inferior, Firefox 141/142 e Firefox 143 e superior como três conjuntos diferentes de instruções. Geralmente é o caso, mas cada vez mais, à medida que mudamos o Firefox a cada quatro semanas, veremos mais mudanças em versões posteriores. Elas terão esta aparência:

  {for not fx141}

  #As instruções antigas.

  {/for}

  {for =fx141,=fx142}

  #As novas instruções.

  {/for}

  {for fx143}

  #As instruções MAIS novas.

  {/for}

Diretrizes completas da Base de Conhecimento

Consulte mais diretrizes sobre contribuição na Base de Conhecimento.