Guia para o desenvolvedor criar links para os artigos de suporte

Contributors Contributors Última atualização: 2 semanas ago
This is a machine-generated translation of the English content. It has not been reviewed by a human, and may contain errors. If you would like to revise this content, you can start here.

Criar links para artigos do Suporte Mozilla é crucial para fornecer aos nossos usuários acesso direto à ajuda que precisam. Existem duas maneiras principais de estabelecer esses links, e o método que você escolhe depende de onde você está criando o link. Este guia irá orientá-lo através de ambos os métodos para garantir que você possa criar links de forma eficaz, ajudando os usuários a encontrar o conteúdo de suporte apropriado sem problemas.

Links no produto para o SUMO

Para links inseridos na interface do navegador Firefox ou Firefox for Android, você deve usar uma estrutura de URL específica. Essa estrutura permite que a equipe de conteúdo da CX ajuste o destino do link sem interromper a funcionalidade no Firefox. Estabelecemos alvos específicos para vários tópicos, o que nos permite direcionar os usuários para os artigos mais relevantes com base em fatores como o sistema operacional ou a versão do Firefox. Essa flexibilidade significa que atualizações ou alterações podem ser feitas diretamente no Kitsune, sem a necessidade de qualquer modificação no código do Firefox.

Aqui está o formato para criar links no produto para artigos do SUMO:

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

Observação: As seções %VERSION%/%OS%/%LOCALE%/ são marcadores de posição. Os engenheiros são responsáveis por preenchê-las dinamicamente no código-fonte.

Exemplo:

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

Nesta estrutura:

  • %VERSION% se refere à versão do Firefox.
  • %OS% representa o sistema operacional do usuário.
  • %LOCALE% especifica as configurações de idioma e região do usuário.
  • TOPIC denota o assunto do artigo de suporte e pode ser qualquer sequência de texto.

Para links específicos do Firefox for Android, a URL deve incluir /1/mobile para distingui-la dos links destinados à versão para computador.

Observação: Ao criar um marcador de posição no SUMO para testar um link no produto, o marcador precisa ser publicado e mantido em administração para que funcione corretamente. Assim que o conteúdo for finalizado e estiver pronto para ser publicado, o artigo deve ser retirado da administração para se tornar visível aos usuários finais.
A criação de links no produto deve ser coordenada através de um tíquete de Solicitação de Conteúdo no Bugzilla, que será gerenciado pela equipe de conteúdo da CX. Por favor, não tente criar esses links manualmente, pois eles precisam ser configurados no Kitsune antes que possam funcionar corretamente.

Evite redirecionamentos para âncoras

Redirecionamentos para âncoras específicas dentro de artigos são frágeis e podem quebrar facilmente se a estrutura da página mudar. Para evitar links quebrados, sempre crie links para a página principal do artigo. Isso garante que seus links permaneçam válidos e que os usuários possam acessar as informações necessárias, independentemente de atualizações nas seções internas do artigo.

Links de propriedades da web para o SUMO

Ao criar links de propriedades da web externas ao Firefox, omita a parte da localidade na URL. Essa prática permite que o sistema SUMO detecte e direcione automaticamente o usuário para a versão do artigo no idioma apropriado, com base nas configurações de seu navegador.

Então, por exemplo, para criar um link para o artigo Atualize o Firefox para a versão mais recente:

  • Use https://support.mozilla.org/kb/update-firefox-latest-release
  • Não use https://support.mozilla.org/en-US/kb/update-firefox-latest-release

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-release?utm_source=nameofsource

Crie um link encurtado mzl.la

Por favor, consulte Como gerar um link mzl.la para ver como você pode criar um link encurtado mzl.la.

Dúvidas?

Se você precisar configurar um link no produto, preencha um tíquete de Solicitação de Conteúdo no Bugzilla. Para qualquer dúvida, deixe uma mensagem neste tópico de suporte.

Saiba mais

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