Uma das grandes características da nossa Base de Conhecimento é a capacidade de mostrar instruções personalizadas para sistemas operacionais (Windows, Android, etc) e as versões do Firefox. Podemos dizer, por exemplo, que uma determinada seção de um artigo de ajuda é "para" usuários de Windows e Mac e Linux não vai vê-lo. O recurso é projetado 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 vai sobre os detalhes de como usar {for} em artigos do Knowledge Base.

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

Aqui está a sintaxe para mostrar uma imagem para Windows only:
{for win}[[Image:vista.jpg]]{/for}

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

Versões do Firefoxs

Aqui está a sintaxe para mostrar algo para o Firefox 9 and above:
{for fx9}[[Image:Firefox Logo]]{/for}

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

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

Para mostrar as instruçõessomente para o Firefox 9, utilize o "=" operador:
{for =fx9}[[Image:Firefox Logo]]{/for}

• Agora, a imagem mostra apenas quando você mudar o seletor para Firefox 9:
  

Firefox 3.5-3.6 works differently. When you specify {for fx35} the instructions will show up only for Firefox 3.5-3.6, the "=" operator isn't needed:
{for fx35}[[Image:Firefox Logo]]{/for}

• Change the selector to Firefox 3.5-3.6 to see an image:
  

Combinando sistemas operacionais e versões do Firefox

You can specify an operating system and a Firefox version by separating them with a comma:
{for win,fx9}[[Image:vista.jpg]][[Image:Firefox Logo]]{/for}

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

A situação mais complexa, com uma implícita "ou" pode ser escrito assim:
{for mac, win, fx35, =fx9}[[Image:vista.jpg]][[Image:macos.jpg]][[Image:Firefox Logo]]{/for}

• Mude o seletor para Mac ou Windows XP ou Windows 7/Vista e Firefox 3.5-3.6 or Firefox9 e acima para ver as imagens:
  

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

• O {for} lista de pelo menos um sistema operacional e inclui o que o usuário está executando (ou selecionou manualmente).
• O {for} lista pelo menos uma versão do Firefox e inclui o que o usuário está executando (ou selecionou manualmente).

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

Algumas outras coisas a serem observados:

• Espaços após as vírgulas são opcionais.
• A sintaxe {for} só funciona no Firefox artigos do Knowledge Base.
• {for} e outra marcação wiki não funciona em resumos de artigos de pesquisa.
• Os títulos que estão escondidos por {for} para blocos não aparecem na tabela de conteúdo da página. Se o usuário faz com que eles mostram manualmente selecionando a combinação OS / browser direita, a tabela de entradas de conteúdos aparecem instantaneamente.

Sistema operacional e navegador abreviaturas

Estes são o sistema operativo e abreviaturas browser disponíveis para utilização com {for}:

• win (Windows)
• mac (Mac OS X)
• linux (Linux)
• android (Android mobile OS)
• fx35 (Firefox 3.5 and 3.6)
• fxN where N = the Firefox version, i.e. fx8, fx9, fx10, etc.
• mN where M = the Firefox version, i.e. m8, m9, m10, etc.

Inline e contextos em nível de bloco

{for} pode ser usado tanto em linha e contextos em nível de bloco (no sentido HTML). A forma de linha tem efeito quando se trabalha dentro de uma linha de texto:

Este é {for win}linha use{/for}.

A forma de bloco é usado para embrulhar parágrafos inteiros, listas ordenadas, títulos e assim por diante. A única ressalva é que, ao usar a forma de bloco, o {for} e {/for} cada um deve estar em uma linha por si só. Caso contrário, ele pode ser considerado parte de um parágrafo vizinho e produzir resultados surpreendentes.

{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}