Configuração da integração do GitHub com seu tema do Guide

Caminho rápido: Administrador do Guide > ícone do Painel de personalização > Adicionar tema > Adicionar do GitHub

A integração com o GitHub permite desenvolver e manter temas colaborativamente no GitHub, para visualização e publicação posteriores na mesma ferramenta. Para configurar a integração, certifique-se primeiro de que o tema está armazenado no GitHub e depois integre no Guide.

Observação: a integração do GitHub com o Guide não oferece suporte ao GitHub Enterprise. Como alternativa, use a API de temas do Guide.

Você precisa ser um administrador do Guide para configurar a integração com o GitHub no Zendesk.

Este artigo abrange os seguintes tópicos:

• Preparação do seu tema no GitHub
• Configuração da integração

Preparação do seu tema no GitHub

Certifique-se de que o tema está no GitHub antes de configurar a integração no Guide. Se você não está familiarizado com Git e GitHub, confira esse tutorial. Se seu tema já está no GitHub e atende aos requisitos a seguir, consulte Configuração da integração no Guide.

A integração tem os seguintes requisitos para o repositório do GitHub:

• O arquivo de manifesto deve estar na raiz do repositório do GitHub

  O arquivo manifest.json deve ser colocado na raiz do repositório do GitHub para que o Guide possa adicionar seu tema. Você pode incluir outros arquivos, como ferramentas, pois eles são ignorados na importação para o Guide.

• O repositório do GitHub pode conter apenas um tema

  Você deve gerenciar apenas um tema em cada repositório. Você pode usar a opção de ramificação durante a importação do tema para experimentar variações do tema.

Como colocar seu tema em um repositório do GitHub

• Se você não tiver um tema no momento, clone o repositório do tema Copenhagen e comece a criar do seu tema. Isso permite que você faça a portabilidade fácil de melhorias do tema Copenhagen para seu tema no futuro.
• Se o seu tema estiver no Guide, baixe-o do Guide e crie um repositório do GitHub (se ainda não tiver um) e coloque o tema nesse repositório.
• Se o seu tema não estiver no Guide nem no GitHub, crie um repositório do GitHub (se ainda não tiver um) e coloque o tema nele.

Após preparar o seu tema no GitHub, você estará pronto para configurar a integração no Guide.

Configuração da integração

Para configurar a integração com o GitHub, verifique se o seu tema está armazenado no GitHub e se consegue transferi-lo do GitHub para o Guide. Essa obtenção única estabelece uma conexão entre o seu tema e o GitHub.

Após configurar a integração, você trabalhará no tema no GitHub e o atualizará no Guide quando estiver pronto. No Guide, você pode visualizar e publicar o tema para uso.

Como configurar a integração com o GitHub com seu tema do Guide

1. No GitHub, verifique se você preparou o seu tema.
2. No Guide, clique no ícone Painel de personalização () na barra lateral.

   A página Temas será exibida.

3. Clique em Adicionar tema no canto superior direito.
4. Clique em Adicionar do GitHub.

   

5. Insira a URL do repositório e, opcionalmente, insira o nome da ramificação (se não for a padrão) e clique em Importar.
6. Se solicitado, entre no GitHub e clique em Authorize Zendesk.

Ao fim da exportação, a miniatura do tema é exibida na página Temas. Em caso de problemas, consulte Resolução de problemas da integração do GitHub para temas do Guide.

Ao estabelecer a conexão entre seu tema no Guide e o GitHub, você gerenciará seu tema no GitHub e o atualizará conforme necessário.