A integração do 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.
Você deve ser um administrador do Guide para configurar a integração do GitHub no Zendesk.
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 o 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 tema do Guide, crie um repositório do GitHub (se ainda não tiver um) e coloque o tema nele.
- 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 seu tema no GitHub, você já pode configurar a interação no Guide.
Configuração da integração
Para configurar a integração no GitHub, você precisa certificar-se de que seu tema está armazenado no GitHub e que ele pode ser colocado no Guide. Essa obtenção única estabelece uma conexão entre o tema o e o GitHub.
Após configurar a integração, você trabalhará no tema GitHub e atualizará no Guide quando estiver pronto. No Guide, você pode visualizar e publicar o tema para uso.
Como configurar a integração do GitHub com seu tema do Guide
- No GitHub, certifique-se de que seu tema está pronto.
- No Guide, clique no ícone Painel de personalização (
) na barra lateral.
A página Temas será exibida.
- Clique em Adicionar tema no canto superior direito.
- Clique em Adicionar do GitHub.
- 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.
- Se solicitado, acesse o 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 Gitub para temas do Guide.
Ao estabelecer a conexão entre seu tema no Guide e o GitHub, você gerenciará seu tema no GitHub e atualizará no Guide conforme for necessário.