Guia para o desenvolvedor criar links para os artigos de suporte

Este artigo pode estar desatualizado.

Uma alteração importante foi feita no artigo original no qual este foi baseado. Até que esta página seja atualizada, você pode achar isto útil: A guide to linking to support articles

Contributors Contributors Última atualização:

Há duas maneiras de criar links para artigos de suporte da Mozilla. Which method you use depends on where you are linking from. Se é do chrome do Firefox ou o Firefox para Android, você vai querer usar o método "in-produto". Se você estiver linkando de uma propriedade da web, então a URL menos a seqüência de localidade é o caminho a percorrer.

Criar links in-product para o SUMO

Metas para botões ou links dentro do chrome navegador deve seguir esse padrão:

https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC

Exemplos:

  • https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/prefs-privacy
  • https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/36eol

A última parte da URL, o topico, pode ser qualquer string.

Firefox para Android deve usar /1/mobile para distinguir o produto.

A tupla (produto, versão, os, local, tema) determina onde o usuário realmente vai. Isso permite que a equipe SUMO para mudar o destino do botão Ajuda, sem quebrar links / botões no Firefox. Temos metas específicas para todos os valores de tópicos e, por vezes, pode se separaram usuários de OS X ou o Windows para os artigos mais relevantes, ou aqueles com / versões específicas antigas do Firefox, etc.

Link para o SUMO de uma propriedade da web

Se esse conteúdo está sendo servido através da web e não acompanha o navegador, você não precisa (e não deve) usar os links in-product

Tudo que você tem a fazer é usar a URL sem o string locale. O SUMO irá enviar automaticamente o usuário para a versão do artigo em sua língua.

Assim, por exemplo, a fim de criar um link para o artigo Atualize o Firefox:
Use

  • https://support.mozilla.org/kb/update-firefox-latest-version

Don't use

  • https://support.mozilla.org/en-US/kb/update-firefox-latest-version

Vinculação de algum outro lugar

Se você não está linkando do Firefox ou um site (talvez um aplicativo, produto, email, etc), você provavelmente vai querer usar a URL (sem o locale) e identificar a fonte.

Exemplo:

  • https://support.mozilla.org/kb/update-firefox-latest-version?utm_source=nameofsource

Questions?

Se você tiver dúvidas ou precisar de configurar o destino final do link no produto, entre em contato com Michael Verdi - mverdi at mozilla.com ou verdi no IRC.

Essas pessoas ajudaram a escrever este artigo:

Illustration of hands

Torne-se um voluntário

Desenvolva e compartilhe sua especialidade com outras pessoas. Responda perguntas e aprimore nossa base de conhecimento.

Saiba mais