Uma das grandes funcionalidades da nossa Base de conhecimentos é a possibilidade de mostrar instruções personalizadas para sistemas operativos (Windows, Mac, etc.) e versões do Firefox. Podemos dizer, por exemplo, que uma determinada secção de um artigo de ajuda é para (''for'') utilizadores do Windows, e os utilizadores do Mac e Linux não irão vê-lo. A funcionalidade está desenhada para ser invisível. Quando alguém abre um artigo de ajuda, iremos detetar automaticamente o sistema operativo e versão do Firefox que estão a utilizar e apresentar as instruções apropriadas. Este artigo aborda os detalhes de como utilizar o <nowiki>{</nowiki>for<nowiki>}</nowiki> em artigos da Base de conhecimentos. {warning} '''Tradutores:''' ao traduzir artigos com os elementos <nowiki>{</nowiki>for<nowiki>}</nowiki> e <nowiki>{</nowiki>/for<nowiki>}</nowiki> no conteúdo, não traduza nada dentro dos { and } parênteses! Mantenha-os exatamente iguais ao texto original. Isto é importante para que a função do elemento funcione devidamente. {/warning} __TOC__ = Como alternar instruções para sistemas operativos ou versões do Firefox diferentes = Para conseguir seguir o exemplo neste artigo, terá que alternar o seletor do artigo para sistemas operativos e versões do Firefox diferentes. Está localizado no topo do artigo. ;[[Image:Article selectors 2015]] = Comportamento e sintaxe básicos = ==Sistemas operativos== Esta é a sintaxe para mostrar uma imagem para o '''Windows 7/Vista''': ;'''<code><nowiki>{</nowiki>for win7<nowiki>}</nowiki><nowiki>[[</nowiki>Image:vista.jpg]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Altere o seletor para Windows 7/Vista para ver a imagem: ;{for win7}[[Image:vista.jpg]]{/for} {for win7} *Se alterar o seletor para Windows XP, Windows 8, Mac OS X ou Linux, a imagem acima não será apresentada pois não é direcionada para estes. {/for} Apesar de não existir um seletor para o Windows, você pode escrever instruções que se aplicam a todas as versões do Windows: ;'''<code><nowiki>{</nowiki>for win<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Windows Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Altere o seletor para Windows XP, Windows 7/Vista, ou Windows 8 para ver a imagem: ;{for win}[[Image:Windows Logo]]{/for} {for win} *Se alterar o seletor para Mac OS X ou Linux, a imagem acima não será apresentada pois não é direcionada para estes. {/for} ==Versões do Firefox== Esta é a sintaxe para mostrar algo para o '''Firefox 29 e superior''': ;'''<code><nowiki>{</nowiki>for fx29<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Firefox Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Altere o seletor para Firefox 29 ou superior para ver a imagem: ;{for fx29}[[Image:Firefox Logo]]{/for} {for fx29} **Se alterar o seletor para Firefox 28 ou inferior, a imagem acima irá desaparecer pois não é direcionada para estes. {/for} ===Apresentar instruções para apenas uma versão do Firefox=== Para mostrar instruções '''apenas para o Firefox 29''', utilize o operador "=": ;'''<code><nowiki>{</nowiki>for =fx29<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Firefox Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *A imagem só aparece quando você alterar o seletor para Firefox 29: ;{for =fx29}[[Image:Firefox Logo]]{/for} ==Combinar sistemas operativos & versões do Firefox== Pode especificar um sistema operativo e uma versão do Firefox separando-os com uma vírgula: ;'''<code><nowiki>{</nowiki>for win,fx29<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Windows Logo]]<nowiki>[[</nowiki>Image:Firefox Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Altere o seletor para Windows e Firefox 29 ou superior para ver imagens: ;{for win,fx29}[[Image:Windows Logo]][[Image:Firefox Logo]]{/for} Uma situação mais complexa com um "for" implícito pode ser escrita assim: ;'''<code><nowiki>{</nowiki>for mac, winxp, win7, =fx28, fx32<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Windows Logo]]<nowiki>[[</nowiki>Image:macos.jpg]]<nowiki>[[</nowiki>Image:Firefox Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' **Altere o seletor para Mac ou Windows XP ou Windows 7/Vista e Firefox 28 ou Firefox 32 e superior para ver imagens: ;{for mac, winxp, win7, =fx28, fx32}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Logo]]{/for} Formalmente, a marcação entre <nowiki>{</nowiki>for<nowiki>}</nowiki> e <nowiki>{</nowiki>/for<nowiki>}</nowiki> será ''apresentada'' se ocorrer uma destas condições: * O <nowiki>{</nowiki>for<nowiki>}</nowiki> lista pelo menos um sistema operativo e inclui o que o utilizador está a utilizar (ou selecionou manualmente). * O <nowiki>{</nowiki>for<nowiki>}</nowiki> 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 <nowiki>{</nowiki>for<nowiki>}</nowiki>…<nowiki>{</nowiki>/for<nowiki>}</nowiki> não serão apresentados. Algumas outras coisas a ter em conta: * Os espaços depois das vírgulas são opcionais. * O <nowiki>{</nowiki>for<nowiki>}</nowiki> e outras marcações da wiki não funciona nos resumos das pesquisas de artigos. * Os cabeçalhos ocultos por blocos do <nowiki>{</nowiki>for<nowiki>}</nowiki> 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 <nowiki>{</nowiki>for<nowiki>}</nowiki>: * 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 (Mac OS X) * linux (Linux) * fxN onde N = versão do Firefox, ex.: fx22, fx23, fx24, etc. * mN onde N = versão do Firefox para Android, ex.: m22, m23, m24, etc. * fxosN onde N = versão do Firefox OS, ex.: fxos1.3, fxos1.4, fxos2.0, etc. * tbN onde N = versão do Thunderbird, ex.: tb24, tb31, tb38, etc. Você tem que usar fxN em artigos de suporte do Firefox, mN em artigos de suporte do Firefox para Android, fxosN em artigos de suporte do Firefox OS e tbN em artigos de suporte do Thunderbird. <!-- This note is outdated. See discussion. {note}'''Note:''' Every six weeks we add support for the latest beta version of Firefox. At the same time we remove the oldest version from the seletor but the old markup will still work. So, for example, if someone views an article with Firefox 19 they will see instructions for their version (see [/forums/knowledge-base-articles/708440 this thread] to know which versions are no longer supported).{/note} --> == Contextos em linha e níveis de bloqueio == O <nowiki>{</nowiki>for<nowiki>}</nowiki> 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 <nowiki>{</nowiki>utilização em linha<nowiki>}</nowiki>para win<nowiki>{</nowiki>/for<nowiki>}</nowiki>.''' 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 <nowiki>{</nowiki>for<nowiki>}</nowiki> e o <nowiki>{</nowiki>/for<nowiki>}</nowiki> 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. ;'''<nowiki>{</nowiki>for win<nowiki>}</nowiki>''' ;'''Isto é um nívl de bloqueio block-level.''' ;'''<nowiki>*</nowiki>Um''' ;'''<nowiki>*</nowiki>Dois''' ;'''<nowiki>{</nowiki>/for<nowiki>}</nowiki>''' ==Utilizar o fragmento <nowiki>{</nowiki>for<nowiki>}</nowiki> na lista de auto-preenchimento == Se não se recorda da sintaxe ao escrever um artigo, basta pressionar {for win,linux}{key Ctrl+Barra de espaço}{/for}{for mac}{key command+barra de espaço}{/for} quando um destacar da sintaxe é ativo, e selecione <code>'''for''' snippet</code> na lista de auto-preenchimento. Ser-lhe-á apresentado o seguinte modelo: <nowiki>{</nowiki>for os_or_firefox_version}texto{/for<nowiki>}</nowiki>. Substitua os tocos pelo o que você quer e já está. =Boas práticas na utilização de <nowiki>{</nowiki>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''' de utilizar o <nowiki>{</nowiki>for}: ;<nowiki>#</nowiki><nowiki>{</nowiki>for not fx29}<nowiki>{</nowiki>for win,linux}No topo da janela do Firefix<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for mac}Na barra de menu<nowiki>{</nowiki>/for}, clique no <nowiki>{</nowiki>/for}<nowiki>{</nowiki>for fx29}Clique no botão de menu, vá ao menu <nowiki>{</nowiki>menu Histórico} <nowiki>{</nowiki>/for}<nowiki>{</nowiki>for winxp,mac,linux,not fx29}<nowiki>{</nowiki>menu Ferramentas}<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for win7,win8,not fx29}<nowiki>{</nowiki>menu Firefox}, vá ao menu <nowiki>{</nowiki>menu Histórico} <nowiki>{</nowiki>/for} e selecione <nowiki>{</nowiki>menu Limpar histórico recente…} *O '''modo correto''' de utilizar o <nowiki>{</nowiki>for}: ;<nowiki>{</nowiki>for not fx29} ;<nowiki>#</nowiki><nowiki>{</nowiki>for win7,win8}No topo da janela do Firefix, clique no menu <nowiki>{menu</nowiki> Firefox}, vá ao menu <nowiki>{menu</nowiki> Histórico} e selecione <nowiki>{menu</nowiki> Limpar histórico recente…}<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for mac}Na barra de menu, clique no menu <nowiki>{menu</nowiki> Ferramentas} e selecione <nowiki>{menu</nowiki> Limpar histórico recente…}<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for winxp,linux}No topo da janela do Firefix, clique no menu <nowiki>{menu</nowiki> Ferramentas} e selecione <nowiki>{menu</nowiki> Limpar histórico recente…}<nowiki>{</nowiki>/for} ;<nowiki>{</nowiki>/for} ;<nowiki>{</nowiki>for fx29} ;<nowiki>#</nowiki>Clique no botão de menu, vá ao menu <nowiki>{menu</nowiki> Histórico} e selecione <nowiki>{menu</nowiki> Limpar histórico recente…}. ;<nowiki>{</nowiki>/for} *No exemplo seguinte, tratamos o Firefox 20 e abaixo, o Firefox 21/22, e Firefox 23 e acima como três conjuntos de instruções diferentes. É muitas vezes o caso, mas à medida que alteramos o Firefox a cada seis semanas iremos ver mais alterações em versões recentes. Eles irão parecer assim: ;<nowiki>{</nowiki>for not fx21} ;<nowiki>#</nowiki>As instruções antigas. ;<nowiki>{</nowiki>/for} ;<nowiki>{</nowiki>for =fx21,=fx22} ;<nowiki>#</nowiki>As instruções novas. ;<nowiki>{</nowiki>/for} ;<nowiki>{</nowiki>for fx23} ;<nowiki>#</nowiki>As novas NOVAS instruções. ;<nowiki>{</nowiki>/for} [[T:ShareArticle|link=http://mzl.la/1b9SAhb]]

Uma das grandes funcionalidades da nossa Base de conhecimentos é a possibilidade de mostrar instruções personalizadas para sistemas operativos (Windows, Mac, etc.) e versões do Firefox. Podemos dizer, por exemplo, que uma determinada secção de um artigo de ajuda é para (for) utilizadores do Windows, e os utilizadores do Mac e Linux não irão vê-lo. A funcionalidade está desenhada para ser invisível. Quando alguém abre um artigo de ajuda, iremos detetar automaticamente o sistema operativo e versão do Firefox que estão a utilizar e apresentar as instruções apropriadas. Este artigo aborda os detalhes de como utilizar o {for} em artigos da Base de conhecimentos.

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

Para conseguir seguir o exemplo neste artigo, terá que alternar o seletor do artigo para sistemas operativos e versões do Firefox diferentes. Está localizado no topo do artigo.

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 Windows 7/Vista para ver a imagem:

Apesar de não existir um seletor para o Windows, você pode escrever 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, ou Windows 8 para ver a imagem:

Versões do Firefox

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

{for fx29}[[Image:Firefox Logo]]{/for}

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

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

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

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

• A imagem só aparece quando você alterar o seletor para Firefox 29:

Combinar sistemas operativos & versões do Firefox

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

{for win,fx29}[[Image:Windows Logo]][[Image:Firefox Logo]]{/for}

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

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

{for mac, winxp, win7, =fx28, fx32}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Logo]]{/for}

• • Altere o seletor para Mac ou Windows XP ou Windows 7/Vista e Firefox 28 ou Firefox 32 e superior para ver 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 (Mac OS X)
• linux (Linux)
• fxN onde N = versão do Firefox, ex.: fx22, fx23, fx24, etc.
• mN onde N = versão do Firefox para Android, ex.: m22, m23, m24, etc.
• fxosN onde N = versão do Firefox OS, ex.: fxos1.3, fxos1.4, fxos2.0, etc.
• tbN onde N = versão do Thunderbird, ex.: tb24, tb31, tb38, etc.

Você tem que usar fxN em artigos de suporte do Firefox, mN em artigos de suporte do Firefox para Android, fxosN em artigos de suporte do Firefox OS e tbN em 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 é 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 de utilizar o {for}:

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

• O modo correto de utilizar o {for}:

{for not fx29}

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

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

{/for}

• No exemplo seguinte, tratamos o Firefox 20 e abaixo, o Firefox 21/22, e Firefox 23 e acima como três conjuntos de instruções diferentes. É muitas vezes o caso, mas à medida que alteramos o Firefox a cada seis semanas iremos ver mais alterações em versões recentes. Eles irão parecer assim:

{for not fx21}

#As instruções antigas.

{/for}

{for =fx21,=fx22}

#As instruções novas.

{/for}

{for fx23}

#As novas NOVAS instruções.

{/for}