Uma das excelentes funcionalidades da nossa Base de Conhecimento é a capacidade de mostrar instruções personalizadas para sistemas operativos (Windows, macOS, Linux) e versões do Firefox. Podemos dizer, por exemplo, que uma determinada secção de um artigo de ajuda é "para" utilizadores do Windows e que os utilizadores de Mac e Linux não a verão. A funcionalidade foi concebida para funcionar de forma invisível. Quando alguém abre um artigo de ajuda, detetamos automaticamente o sistema operativo e a versão do Firefox que está a utilizar e mostramos as instruções adequadas. Este artigo aborda os detalhes de como utilizar a marcação {for} nos artigos da Base de Conhecimento.

Como mudar as instruções para sistemas operativos ou versões do Firefox diferentes

Para seguir o exemplo neste artigo, terá de mudar o seletor do artigo para diferentes sistemas operativos e versões do Firefox. Este está localizado no painel direito do artigo, em Ferramentas de Edição.

Comportamento e sintaxe básicos

Sistemas operativos

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

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

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

  

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

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

• Altere 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}

• Altere 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 apenas para o Firefox 140, utilize o operador "=":

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

• Agora a imagem só aparece quando alterar o seletor para Firefox 140:

  

Combinar sistemas operativos e versões do Firefox

Pode especificar um sistema operativo e uma versão do Firefox separando-os com uma vírgula:

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

• Altere 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}

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

  

Negar condições

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

not fx140

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

Aproveitar as etiquetas {for} para controlo avançado de versões

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

• Acesso antecipado para utilizadores Nightly e Beta: Permite-nos apresentar funcionalidades ou alterações futuras aos utilizadores que estão nos canais Nightly e Beta, dando-lhes um avanço sobre o que podem encontrar. Isto garante que os nossos utilizadores mais empenhados e técnicos possam começar a explorar novas funcionalidades antes da comunidade em geral.
• Localização antes do lançamento: As etiquetas for permitem-nos publicar conteúdo para as próximas versões antes do seu lançamento público. Isto permite que a nossa comunidade de localização prepare as traduções mais cedo, garantindo o suporte multilingue no momento em que uma nova versão é lançada no canal de Produção.
• Evitar confusão entre o público em geral: Utilizando as etiquetas for, evitamos estrategicamente expor o nosso público em geral a informações prematuras, evitando assim a confusão sobre o que está atualmente disponível na sua versão atual do Firefox.

Quando é que os conteúdos são mostrados

Formalmente, a marcação entre {for} e {/for} será mostrada se ambas as seguintes condições forem cumpridas:

• A etiqueta {for} não tem nenhuma condição de sistema operativo (SO), ou tem pelo menos uma condição de SO que é verdadeira em relação ao SO que o utilizador está a executar (ou selecionou manualmente).
• A etiqueta {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 utilizador está a executar (ou selecionou manualmente).

Caso contrário, os conteúdos de {for}…{/for} não são mostrados.

Algumas outras coisas a ter em conta:

• Os espaços depois das vírgulas são opcionais.
• O {for} e outras marcações da wiki não funciona nos resumos das pesquisas de artigos.
• Os cabeçalhos ocultos por blocos do {for} não aparecem na tabela de conteúdos da página. Se o utilizador fizer com que estes apareçam selecionando manualmente a combinação Sistema operativo/navegador correta, as entradas da tabela de conteúdos aparecem instantaneamente.

Abreviações de sistema operativo e de produtos

Estas são as abreviaturas de sistema operativo e de produto disponíveis para utilização 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 (computador), por exemplo fx115, fx116, fx117, etc.
• mN onde N = a versão do Firefox for Android (dispositivo móvel), por exemplo m115, m116, m117, etc.
• tbN onde N = a versão do Thunderbird, por exemplo tb91, tb102, tb115, etc.

Tem de utilizar fxN nos artigos de suporte do Firefox, mN nos artigos de suporte do Firefox for Android e tbN nos artigos de suporte do Thunderbird.

Contextos em linha e níveis de bloqueio

O {for} pode ser utilizado em ambos os contextos em linha ou níveis de bloqueio (no sentido HTML). A forma em linha tem efeito se funcionar dentro de uma linha de texto:

Isto é {for win}utilização em linha{/for}.

A forma de bloqueio é utilizada para envolver parágrafos inteiros, listas ordenadas, cabeçalhos, e por aí fora. O único embargo é que, ao utilizar a forma de bloqueio, o {for} e o {/for} deverão estar cada um em linha por si só. Caso contrário, pode ser considerado parte de um parágrafo vizinho e produzir resultados surpreendentes.

{for win}

Isto é ao nível do bloco.

*Um

*Dois

{/for}

Melhores práticas para utilizar {for} em artigos

Ao escrever instruções para diferentes sistemas operativos, é melhor escrever frases e parágrafos completos para cada versão de SO/Firefox, mesmo que isso signifique duplicar coisas. Isto torna o artigo mais fácil de compreender, manter e localizar. Quando chegar a altura, por exemplo, de remover instruções específicas para o Firefox 140 e inferior, essas secções podem ser simplesmente eliminadas em vez de tentar retirá-las de uma secção maior.

• A forma errada de utilizar {for}:

  #{for not fx140}{for win,linux}No topo da janela do Firefox{/for}{for mac}Na barra de menus{/for}, clique no {/for}{for fx140}Clique no botão de menu, vá para o menu {menu History}{/for}{for winxp,mac,linux,not fx140}menu {menu Tools}{/for}{for win10,win11,not fx140}menu {menu Firefox}, vá para o menu {menu History}{/for} e selecione {menu Clear Recent History…}

• A forma correta de utilizar {for}:

  {for not fx140}

  #{for win10,win11}No topo da janela do Firefox, clique no menu {menu Firefox}, vá para o menu {menu History} e selecione {menu Clear Recent History…}{/for}{for mac}Na barra de menus, clique no menu {menu Tools} e selecione {menu Clear Recent History…}{/for}{for winxp,linux}No topo da janela do Firefox, clique no menu {menu Tools} e selecione {menu Clear Recent History…}{/for}

  {/for}

  {for fx140}

  #Clique no botão de menu, vá para o menu {menu History} e selecione {menu Clear Recent History…}

  {/for}

• No exemplo seguinte, tratamos o Firefox 140 e inferior, o Firefox 141/142 e o Firefox 143 e superior como três conjuntos diferentes de instruções. É frequente ser esse o caso, mas à medida que alteramos o Firefox a cada quatro semanas, veremos mais alterações nas versões posteriores. Terão este aspeto:

  {for not fx141}

  #As instruções antigas.

  {/for}

  {for =fx141,=fx142}

  #As instruções novas.

  {/for}

  {for fx143}

  #As NOVAS novas instruções.

  {/for}

Diretrizes completas da Base de Conhecimento

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