Como utilizar o "For"

Contributors, Firefox Contributors, Firefox Última actualização:

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'.

Tradutores: quando traduzirem artigos com os elementos {for} e {/for} no conteúdo, não traduzam nada dentro dos parênteses {}! Mantenham-os exatamente iguais ao texto original. Isto é importante para que a função do elemento funcione corretamente.

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.

VersionSelector-2018

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:
vista.jpg
  • Se alterar o seletor para o Windows XP, Windows 8, Windows 10, Mac ou Linux, a imagem acima não será mostrada porque não é "for" ("para") estes.

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:
Windows Logo
  • Se alterar o seletor para Mac ou Linux, a imagem acima não será mostrada pois não "for" ("para") para estes.

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:
Firefox Quantum Logo
    • Se alterar o seletor para Firefox 62 ou inferior, a mensagem acima irá desaparecer porque não é "for" ("para") essas versões.

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:
Firefox Quantum Logo

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:
Windows LogoFirefox Quantum Logo

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:
Windows Logomacos.jpgFirefox Quantum Logo


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}

 

Este artigo foi útil?

Por favor, aguarde...

Estas pessoas fantásticas ajudaram a escrever este artigo:

Illustration of hands

Participar

Cresça e partilhe a sua experiência com outras pessoas. Responda a perguntas e melhore a nossa base de conhecimentos.

Saber mais