Um dos grandes recursos da nossa Base de Conhecimento é a capacidade de mostrar instruções personalizadas para diferentes sistemas operacionais (Windows, Android, etc) versões do Firefox. Podemos dizer, por exemplo, que uma determinada seção de um artigo de ajuda é "para" (inglês: "for") usuários de Windows, ocultando essa seção dos usuários de Mac e Linux. O recurso foi desenvolvido para funcionar de forma invisível. Quando alguém abre um artigo de ajuda, vamos detectar automaticamente o sistema operacional e versão do Firefox que eles estão usando e mostrar as instruções apropriadas. Este artigo fala como usar {for} em artigos do nossa Base de Conhecimento.

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

Para seguir o exemplo neste artigo, você vai ter que mudar o seletor de artigo para diferentes sistemas operacionais e versões do Firefox. Ele está localizado na parte superior do artigo.

Sintaxe básica e comportamento

Sistemas operacionais

Esta é a sintaxe para mostrar uma imagem somente para usuários do Windows:
{for win7}[[Image:vista.jpg]]{/for}

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

Apesar de um seletor para Windows não existir, é possível escrever instruções que se apliquem para todas as versões do Windows:
{for win}[[Image:Windows Logo]]{/for}

• Mude o seletor para Windows XP, Windows 7/Vista, ou Windows 8 para ver a imagem:
  A imagem "Windows Logo.jpg" não existe.

Versões do Firefox

Aqui está a sintaxe para mostrar algo para versões do Firefox 22 ou mais recentes:
{for fx22}[[Image:Firefox Logo]]{/for}

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

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

Para mostrar as instruçõessomente para o Firefox 22, utilize o sinal "=":
{for =fx22}[[Image:Firefox Logo]]{/for}

• Agora, a seguinte imagem é exibida apenas quando você mudar o seletor para Firefox 22:
  

Combinando sistemas operacionais e versões do Firefox

É possível especificar um sistema operacional e uma versão do Firefox separando-os com uma vírgula:
{for win,fx22}[[Image:Windows Logo.jpg]][[Image:Firefox Logo]]{/for}

• Mude o seletor para Windows e Firefox 22 ou superior para ver as imagens:
  A imagem "Windows Logo.jpg" não existe.

Um exemplo mais complexo, com um "ou" (inglês: "or") pode ser escrito assim:
{for mac, winxp, win7, =fx17, fx22}[[Image:vista.jpg]][[Image:macos.jpg]][[Image:Firefox Logo]]{/for}

• Mude o seletor para Mac ou Windows XP ou Windows 7/Vista, e Firefox ESR ou Firefox 22 e superior para ver as imagens:
  

Formalmente, a marcação entre {for} e {/for} será exibida se qualquer uma destas condições sejam satisfeitas:

• O {for} lista pelo menos um sistema operacional, incluso o que o usuário está utilizando (ou selecionou manualmente).
• O {for} lista pelo menos uma versão do Firefox, incluso a que o usuário está utilizando (ou selecionou manualmente).

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

Algumas outras coisas a serem observados:

• Espaços após as vírgulas são opcionais.
• A sintaxe {for} só funciona nos artigos da Base de Conhecimentos do Firefox.
• {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 oeracional e a versão do navegador, essas entradas no índice de conteúdo aparecerão automaticamente.

Abreviações de sistemas operacionais e navegadores

Estas são as abreviações dos sistemas operacionais e dos navegadores disponíveis para utilização com {for}:

• win (Windows)
• mac (Mac OS X)
• linux (Linux)
• android (Android)
• fx35 (Firefox 3.5 e 3.6)
• fxN onde N = versão do Firefox, por exemplo, fx8, fx9, fx10, etc.
• mN onde M = versão do Firefox para Android, por exemplo, m8, m9, m10, etc.

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. Por exemplo:

{for win}
Esta é em nível de bloco.
*Um
*Dois
{/for}

Usando o botão dandy acessível {for} no editor de artigo

Quando você está editando um artigo da Base de Conhecimento, você pode usar o {for} botão na barra de ferramentas para escrever a marcação para você.

1. Selecione o texto que você deseja colocar {for} marcas ao redor.
2. Clique em Mostrar para... na barra de ferramentas de edição.
3. Marque as caixas ao lado das versões do Firefox e sistemas operacionais que você quer ver este pedaço de conteúdo e, em seguida, clique em Adicionar regra. Os personalizadas {for} tags serão colocados ao redor da seção que você destacou.

Melhores práticas para usar {for} em artigos

Ao escrever instruções para diferentes sistemas operacionais, é melhor para escrever frases e parágrafos completos para cada versão do OS / Firefox mesmo se isso significa duplicar as coisas. Isso torna o artigo mais fácil de entender, manter e localizar. Quando se trata de tempo, por exemplo, para remover as instruções específicas para o Firefox 3.5/3.6 instruções especificas, as seções podem simplesmente ser apagados, em vez de tentar extirpar-los de uma seção maior.

Exemplo:
Bad
#{for win,linux}At the top of the Firefox window{/for}{for mac}On the menu bar{/for}, click on the {for fx35}{menu Tools}{/for}{for mac,linux,fx4}{menu Tools}{for win,fx4}{menu Firefox} menu, go over to the {menu History} menu and select {menu Clear Recent History...}{/for}{for not win,fx4} menu, and select {/for}{for win,fx35}{menu Clear Recent History...}{/for}{for mac,linux}{menu Clear Recent History...}{/for} {for win,fx4}<br>'''For Windows XP:''' At the top of the Firefox window, click on the {menu Tools} menu and select {menu Clear Recent History...}{/for}

Boa
{for fx4}
#{for win}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...} ('''Windows XP:''' Click on the {menu Tools} 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 linux}At the top of the Firefox window, click on the {menu Tools} menu and select {menu Clear Recent History...}{/for}
{/for}
{for fx35}
#{for win,linux}At the top of the Firefox window, click on the {menu Tools} 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}

Outro exemplo:
In the example above we treat Firefox 3.6 and Firefox 4 and above as two different sets of instructions. That's often the case but more and more as we change Firefox every six weeks we'll see more changes in later versions. They'll look like this:

Bom:
{for fx35}
#Os velhos instruções.
{/for}
{for =fx8,=fx9}
#As novas instruções.
{/for}
{for fx10}
#O novo novas instruções.
{/for}