Uma das fantásticas funcionalidades da nossa Base de Conhecimentos é a possibilidade de mostrar instruções personalizadas para os sistemas operativos (MAc, Windows, etc.) e versões do Firefox. Nós podemos dizer, por exemplo, que uma determinada secção de um artigo de ajuda é for ("para") os utilizadores do Windows, e os utilizadores do Mac e do Linux não irão vê-lo. A funcionalidade foi criada para funcionar invisível. Quando alguém abre um artigo de ajuda, nós iremos detetar automaticamente o sistema operativo e a versão do Firefox que eles estão a utilizar e nós mostramos as instruções apropriadas. Este artigo aborda os detalhes de como utilizar {for} nos artigos da 'Base de Conhecimentos'.

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

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

Comportamento e sintaxe básicos

Sistemas Operativos

Esta é a sintaxe para mostrar uma imagem para o Windows 7/Vista:

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

• Altere o seletor para o Windows 7/Vista para ver a imagem:

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

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

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

Versões do Firefox

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

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

• Altere o seletor para Firefox 63 ou superior para ver a imagem:

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

Para mostrar as instruções apenas para o Firefox 63, utilize o operador "=":

{for =fx63}[[Image:Firefox Logo]]{/for}

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

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,fx63}[[Image:Windows Logo]][[Image:Quantum Logo]]{/for}

• Altere o seletor para Windows e Firefox 63 ou superior para ver as imagens:

Uma situação mais complexa com um "for" implícito pode ser escrita assim:

{for mac, winxp, win7, =fx61, fx63}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for}

• • Altere o seletor para Mac ou Windows XP ou Windows 7/Vista e Firefox 61 ou Firefox 63 e superior para ver as imagens:

Formalmente, a marcação entre {for} e {/for} será apresentada se ocorrer uma destas condições:

• O {for} lista pelo menos um sistema operativo e inclui o que o utilizador está a utilizar (ou selecionou manualmente).
• O {for} lista pelo menos uma versão do Firefox e inclui a que o utilizador está a utilizar (ou selecionou manualmente).

Caso contrário, os conteúdos do {for}…{/for} não serão apresentados.

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 abreviações de sistemas operativos e produtos disponíveis para usar com o {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)
• mac (macOS)
• linux (Linux)
• fxN onde N = a versão do Firefox, ex.: fx62, fx63, fx624, etc.
• mN onde N = a versão do Firefox para Android, ex.: m22, m23, m24, etc.
• tbN onde N = versão do Thunderbird, ex.: tb24, tb31, tb38, etc.

Tem que utilizar fxN nos artigos de apoio do Firefox, mN nos artigos de apoio do Firefox para Android, fxosN nos artigos de apoio do Firefox OS e tbN nos artigos de apoio 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 é para {utilização em linha}para win{/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 é um nívl de bloqueio block-level.

*Um

*Dois

{/for}

Utilizar o fragmento {for} na lista de auto-preenchimento

Se não se recorda da sintaxe ao escrever um artigo, basta pressionar Ctrl + Barra de espaçocommand + barra de espaço quando um destacar da sintaxe é ativo, e selecione for snippet na lista de auto-preenchimento. Ser-lhe-á apresentado o seguinte modelo: {for os_or_firefox_version}texto{/for}. Substitua os tocos pelo o que você quer e já está.

Boas práticas na utilização de {for} e artigos

Ao escrever instruções para sistemas operativos diferentes, é melhor escrever frases e parágrafos completos para cada versão do Firefox/sistema operativo mesmo se significar duplicar coisas. Isto torna o artigo fácil de compreender, gerir e traduzir. Quando for necessário, por exemplo, remover instruções específicas para o Firefox 12 e inferior, essas secções podem simplesmente ser apagadas em vez de os tentar carregar de uma secção maior.

• O modo errado para utilizar {for}:

#{for not fx63}{for win,linux}No topo da janela do Firefix{/for}{for mac}Na barra de menu{/for}, clique no {/for}{for fx63}Clique no botão de menu, vá ao menu {menu Histórico} {/for}{for winxp,mac,linux,not fx63}{menu Ferramentas}{/for}{for win7,win8,not fx63}{menu Firefox}, vá ao menu {menu Histórico} {/for} e selecione {menu Limpar histórico recente…}

• O modo correto para utilizar {for}:

{for not fx63}

#{for win7,win8}No topo da janela do Firefix, clique no menu {menu Firefox}, vá ao menu {menu Histórico} e selecione {menu Limpar histórico recente…}{/for}{for mac}Na barra de menu, clique no menu {menu Ferramentas} e selecione {menu Limpar histórico recente…}{/for}{for winxp,linux}No topo da janela do Firefix, clique no menu {menu Ferramentas} e selecione {menu Limpar histórico recente…}{/for}

{/for}

{for fx63}

#Clique no botão de menu, vá ao menu {menu Histórico} e selecione {menu Limpar histórico recente…}.

{/for}

• No exemplo seguinte, nós tratamos o Firefox 60 e inferior, o Firefox 61/62, e o Firefox 63 e superior como três conjuntos de instruções diferentes. É muitas vezes o caso, mas à medida que nós alteramos o Firefox a cada seis semanas nós iremos ver mais alterações nas versões recentes. Elas irão parecer assim:

{for not fx61}

#As instruções antigas.

{/for}

{for =fx61,=fx62}

#As instruções novas.

{/for}

{for fx63}

#As novas 'NOVAS' instruções.

{/for}