Thelekisa Uhlaziyo

Aprenda a usar a marcação “for” nos artigos do Suporte Mozilla, para exibir conteúdo para diferentes sistemas operacionais e versões de produtos

Um dos grandes recursos da nossa Base de Conhecimento é a capacidade de mostrar instruções personalizadas para sistemas operacionais (Windows, macOS, Linux) e versões do Firefox. Podemos dizer, por exemplo, que uma determinada seção de um artigo de ajuda é “para” usuários do Windows e usuários de Mac e Linux não a verão. O recurso foi projetado para funcionar de forma invisível. Quando alguém abre um artigo de ajuda, detectamos automaticamente qual sistema operacional e versão do Firefox a pessoa está usando e mostramos as instruções apropriadas. Este artigo detalha como usar a marcação <nowiki>{</nowiki>for<nowiki>}</nowiki> em artigos da Base de Conhecimento. {warning}'''Tradutores:''' Ao traduzir artigos com elementos <nowiki>{</nowiki>for<nowiki>}</nowiki> e <nowiki>{</nowiki>/for<nowiki>}</nowiki> no conteúdo, '''não traduza''' nada dentro dos colchetes { e }! Mantenha-os da mesma forma que aparecem no texto original. Isso é importante para que o elemento funcione corretamente.{/warning} __TOC__ = Como alternar instruções para diferentes sistemas operacionais ou versões do Firefox = Para seguir o exemplo neste artigo, você terá que mudar o seletor do artigo para diferentes sistemas operacionais e versões do Firefox. Ele está localizado no painel direito do artigo, em ''Editing Tools''. ;[[Image:CustomizeThisArticle-2025]] = Sintaxe básica e comportamento = ==Sistemas operacionais== Esta é a sintaxe para mostrar uma imagem para o '''Windows 10''': ;'''<code><nowiki>{</nowiki>for win10<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Windows Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Mude o seletor para Windows 10 para ver a imagem: *;{for win10}[[Image:Windows Logo]]{/for} {for win10} *Se você mudar o seletor para Windows XP, Windows 7, Windows 8, Windows 11, Mac ou Linux, a imagem acima não será exibida porque não é “para” eles. {/for} Apesar de não existir um seletor para 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:Image:vista.jpg]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Mude o seletor para Windows XP, Windows 7/Vista, Windows 8, Windows 10 ou Windows 11 para ver a imagem: *;{for win}[[Image:vista.jpg]]{/for} {for win} *Se você mudar o seletor para Mac ou Linux, a imagem acima não será exibida porque não é “para” eles. {/for} ==Versões do Firefox== Esta é a sintaxe para mostrar algo para o '''Firefox 140 e superior''': ;'''<code><nowiki>{</nowiki>for fx140<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Firefox Quantum Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Mude o seletor para Firefox 140 ou superior para ver a imagem: *;{for fx140}[[Image:Firefox Quantum Logo]]{/for} {for fx139} *Se você mudar o seletor para Firefox 139 ou inferior, a imagem acima irá desaparecer porque não é “para” essas versões. {/for} ===Mostrar instruções para apenas uma versão do Firefox=== Para mostrar instruções '''somente para o Firefox 140''', use o operador “=”: ;'''<code><nowiki>{</nowiki>for =fx140<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Firefox Quantum Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Agora a imagem só aparece quando você muda o seletor para Firefox 140: *;{for =fx140}[[Image:Firefox Quantum Logo]]{/for} ==Combinando sistemas operacionais e versões do Firefox== Você pode especificar um sistema operacional e uma versão do Firefox separando-os com uma vírgula: ;'''<code><nowiki>{</nowiki>for win,fx140<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Windows Logo]]<nowiki>[[</nowiki>Image:Quantum Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Mude o seletor para Windows e Firefox 140 ou superior para ver as imagens: *;{for win,fx140}[[Image:Windows Logo]][[Image:Firefox Quantum Logo]]{/for} Uma situação mais complexa com um “para” implícito pode ser escrita assim: ;'''<code><nowiki>{</nowiki>for mac, win10, win11, =fx128, fx140<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Windows Logo]]<nowiki>[[</nowiki>Image:macos.jpg]]<nowiki>[[</nowiki>Image:Firefox Quantum Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>''' *Mude o seletor para Mac ou Windows 10 ou Windows 11 e Firefox 128 ou Firefox 140 e superior para ver as imagens: *;{for mac, win10, win11, =fx128, fx140}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for} ==Negando condições== Você pode negar uma condição precedendo-a com a palavra <code>not</code>. Uma condição negada é verdadeira se, e somente se, a condição for falsa. Por exemplo, a condição ;'''<code>not fx140</code>''' é verdadeira se a versão do Firefox for inferior a 140. ==Aproveite as tags <nowiki>{</nowiki>for<nowiki>}</nowiki> para controle avançado de versões== Com atualizações e lançamentos de recursos frequentes no Firefox, as tags ''for'' desempenham um papel fundamental na curadoria de conteúdo direcionado, permitindo-nos fornecer informações relevantes aos usuários com base em sua versão específica do Firefox. As principais aplicações dessas tags incluem: *'''Acesso antecipado para usuários do Nightly e Beta:''' Permite-nos apresentar futuros recursos ou alterações aos usuários que estão nos canais Nightly e Beta, dando-lhes um aviso sobre o que podem encontrar. Isso garante que nossos usuários mais engajados e técnicos possam começar a explorar novas funcionalidades antes da comunidade em geral. *'''Tradução antes do lançamento:''' As tags ''for'' nos permitem publicar conteúdo para as próximas versões antes de seu lançamento público. Isso permite que nossa comunidade de tradução prepare as traduções com antecedência, garantindo suporte em vários idiomas no momento em que uma nova versão for lançada no canal de produção. *'''Evitar confusão entre o público em geral:''' Usando as tags ''for'', evitamos estrategicamente expor nosso público em geral a informações prematuras, evitando assim confusão sobre o que está atualmente disponível em sua versão atual do Firefox. ==Quando o conteúdo é exibido== Formalmente, a marcação entre <nowiki>{</nowiki>for<nowiki>}</nowiki> e <nowiki>{</nowiki>/for<nowiki>}</nowiki> será ''exibida'' se ambas as condições a seguir forem atendidas: * O <nowiki>{</nowiki>for<nowiki>}</nowiki> não tem nenhuma condição de sistema operacional (SO), ou tem pelo menos uma condição de SO que é verdadeira em relação ao SO que o usuário está executando (ou selecionou manualmente). * O <nowiki>{</nowiki>for<nowiki>}</nowiki> não tem nenhuma condição de versão do Firefox, ou tem pelo menos uma condição de versão do Firefox que é verdadeira em relação à versão do Firefox que o usuário está executando (ou selecionou manualmente). Caso contrário, o conteúdo de <nowiki>{</nowiki>for<nowiki>}</nowiki>…<nowiki>{</nowiki>/for<nowiki>}</nowiki> não é exibido. {note}Qualquer conteúdo dentro de uma tag <nowiki>{</nowiki>for<nowiki>}</nowiki>, destinado a versões anteriores do Firefox, permanece visível para os usuários dessas versões, mesmo que essas versões não estejam listadas no seletor de versão.{/note} Algumas outras coisas a serem observadas: * Espaços após as vírgulas são opcionais. * <nowiki>{</nowiki>for<nowiki>}</nowiki> e outras marcações wiki não funcionam no resumo dos artigos. * Os títulos que estão escondidos pelos blocos de <nowiki>{</nowiki>for<nowiki>}</nowiki> 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 operacional e a versão do navegador, essas entradas no índice de conteúdo aparecerão automaticamente. == Abreviações de sistema operacional e produto == Estas são as abreviações de sistema operacional e produto disponíveis para uso com <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) * win11 (Windows 11) * mac (macOS) * linux (Linux) * fxN onde N = a versão do Firefox (desktop), por exemplo fx115, fx116, fx117, etc. * mN onde N = a versão do Firefox for Android (mobile), por exemplo m115, m116, m117, etc. * tbN onde N = a versão do Thunderbird, por exemplo tb91, tb102, tb115, etc. Você deve usar fxN em artigos de suporte do Firefox, mN em artigos de suporte do Firefox for Android e tbN em artigos de suporte do Thunderbird. == Contextos alinhado e em bloco == <nowiki>{</nowiki>for<nowiki>}</nowiki> 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 <nowiki>{</nowiki>for win<nowiki>}</nowiki>alinhado<nowiki>{</nowiki>/for<nowiki>}</nowiki>.''' 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 <nowiki>{</nowiki>for<nowiki>}</nowiki> e <nowiki>{</nowiki>/for<nowiki>}</nowiki> 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. ;'''<nowiki>{</nowiki>for win<nowiki>}</nowiki>''' ;'''Esta é em nível de bloco.''' ;'''<nowiki>*</nowiki>Um''' ;'''<nowiki>*</nowiki>Dois''' ;'''<nowiki>{</nowiki>/for<nowiki>}</nowiki>''' = Melhores práticas ao usar <nowiki>{</nowiki>for} em artigos = '''Ao escrever instruções para diferentes sistemas operacionais, é melhor escrever frases e parágrafos completos para cada versão de SO/Firefox, mesmo que isso signifique duplicar coisas.''' Isso torna o artigo mais fácil de entender, manter e traduzir. Quando chegar a hora, por exemplo, de remover instruções específicas para o Firefox 140 e versões anteriores, essas seções podem simplesmente ser excluídas, em vez de tentar extraí-las de uma seção maior. *A '''maneira errada''' de usar <nowiki>{</nowiki>for}: *;<nowiki>#</nowiki><nowiki>{</nowiki>for not fx140}<nowiki>{</nowiki>for win,linux}At the top of the Firefox window<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for mac}On the menu bar<nowiki>{</nowiki>/for}, click on the <nowiki>{</nowiki>/for}<nowiki>{</nowiki>for fx140}Click the menu button, go over to the <nowiki>{</nowiki>menu History} menu<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for winxp,mac,linux,not fx140}<nowiki>{</nowiki>menu Tools} menu<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for win10,win11,not fx140}<nowiki>{</nowiki>menu Firefox} menu, go over to the <nowiki>{</nowiki>menu History} menu<nowiki>{</nowiki>/for} and select <nowiki>{</nowiki>menu Clear Recent History…} *A '''maneira certa''' de usar <nowiki>{</nowiki>for}: *;<nowiki>{</nowiki>for not fx140} *;<nowiki>#</nowiki><nowiki>{</nowiki>for win10,win11}At the top of the Firefox window, click on the <nowiki>{menu</nowiki> Firefox} menu, go over to the <nowiki>{menu</nowiki> History} menu and select <nowiki>{menu</nowiki> Clear Recent History…}<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for mac}On the menu bar, click on the <nowiki>{menu</nowiki> Tools} menu and select <nowiki>{menu</nowiki> Clear Recent History…}<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for winxp,linux}At the top of the Firefox window, click on the <nowiki>{menu</nowiki> Tools} menu and select <nowiki>{menu</nowiki> Clear Recent History…}<nowiki>{</nowiki>/for} *;<nowiki>{</nowiki>/for} *;<nowiki>{</nowiki>for fx140} *;<nowiki>#</nowiki>Click the menu button, go over to the <nowiki>{menu</nowiki> History} menu and select <nowiki>{menu</nowiki> Clear Recent History…} *;<nowiki>{</nowiki>/for} *No exemplo a seguir, tratamos o Firefox 140 e inferior, Firefox 141/142 e Firefox 143 e superior como três conjuntos diferentes de instruções. Geralmente é o caso, mas cada vez mais, à medida que mudamos o Firefox a cada quatro semanas, veremos mais mudanças em versões posteriores. Elas terão esta aparência: *;<nowiki>{</nowiki>for not fx141} *;<nowiki>#</nowiki>As instruções antigas. *;<nowiki>{</nowiki>/for} *;<nowiki>{</nowiki>for =fx141,=fx142} *;<nowiki>#</nowiki>As novas instruções. *;<nowiki>{</nowiki>/for} *;<nowiki>{</nowiki>for fx143} *;<nowiki>#</nowiki>As instruções MAIS novas. *;<nowiki>{</nowiki>/for} = Diretrizes completas da Base de Conhecimento = Consulte [https://support.mozilla.org/en-US/products/contributor/kb mais diretrizes sobre contribuição na Base de Conhecimento].