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.
Tabela de conteúdos
- 1 Como mudar as instruções para sistemas operativos ou versões do Firefox diferentes
- 2 Comportamento e sintaxe básicos
- 3 Boas práticas na utilização de {for} e artigos
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:
- 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:
- 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:
- 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:
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}