Trabalho local em um tema

Os recursos de tema mais poderosos do Guide são a importação, download e trabalho local com temas. Ao implementar grandes atualizações a um tema ou criar um tema do zero, essas opções otimizam o trabalho dos desenvolvedores.

O fluxo de trabalho para criar um novo tema ou atualizar localmente um tema existente é o seguinte:

1. Criação de um novo tema adicionando o tema Copenhagen ou duplicando um tema existente.
2. Download de seu tema para trabalhar offline.
3. Edição local do seu tema com suas ferramentas de desenvolvimento próprias.
4. Importação do seu tema para o Guide.
5. Publicação do seu novo tema.
6. Atualizações adicionais.

Criação de um novo tema

Se você está criando um tema do zero, considere começar com uma nova versão do tema Copenhagen padrão. Para fazer isso, adicione um novo tema para que uma cópia zerada do Copenhagen seja adicionada à página Temas. É possível obter a versão nova do tema no repositório Copenhagen open-source no GitHub.

Muitos gostam de começar trabalhando com um tema existente, fazendo modificações importantes para criar temas próprios. Se você estiver reprojetando um tema existente e desejar manter alguns estilos existentes, pode duplicar o tema.

Para começar um novo tema adicionando uma cópia zerada do Copenhagen ou copiando o tema existente, consulte Adição de um tema da central de ajuda ao Guide.

Download de seu tema

Agora você está pronto para baixar seu tema do Guide. O tema é baixado como um arquivo zip contendo modelos, JavaScript, CSS e ativos. Isso permite que você mexa no seu tema fora do Guide, usando ferramentas de desenvolvimento próprias.

Para baixar seu tema, consulte Download de um tema da central de ajuda.

Edição local do seu tema

Agora você está pronto para começar a trabalhar em seu computador local, usando ferramentas de desenvolvimento próprias.

Para evitar a compactação e importação dos arquivos para o Guide toda vez que desejar visualizar suas alterações, você pode visualizar cada alteração localmente em um navegador usando as ferramentas de aplicativos do Zendesk (ZAT). O objetivo da visualização local é permitir que os desenvolvedores de tema trabalhem com as ferramentas com as quais estão familiarizados para criar os temas de maneira rápida e fácil. Para configurar a visualização do tema ZAT, consulte Visualização local de alterações do tema.

Após iniciar o modo de pré-visualização, você pode modificar os arquivos do tema em seu editor de texto favorito. A visualização local é atualizada em tempo real. Assim, todas as alterações feitas aos arquivos atualizarão automaticamente a visualização. Daqui você pode fazer alterações rápidas aos modelos, CSS, JavaScript e ativos.

Além disso, quando você baixa um tema para sua máquina local, é recomendável colocá-lo em seu repositório de controle de versão favorito, tais como Git, Mercurial, SVN, etc.

Sua equipe pode também desenvolver e manter temas colaborativamente no GitHub, para visualização e publicação posteriores na mesma ferramenta do GitHub. Consulte Configuração da integração do GitHub com seu tema do Guide.

Importação do seu tema

Após criar seu tema localmente, compacte o diretório do tema em um arquivo ZIP e importe-o para o Guide, arrastando e soltando o arquivo na página Temas ou usando a opção de importação.

Isso importará o tema como o novo tema personalizado. Você pode visualizá-lo melhor no Guide e outros usuários na sua organização poderão ver o tema.

Para importar seu tema, consulte Importação de um tema da central de ajuda.

Se você configurar uma integração com o GitHub, pode atualizar um tema no Guide do GitHub. Você não precisa criar um arquivo ZIP individual e importá-lo. Consulte Atualização do seu tema gerenciado pelo Github no Guide.

Outra opção é criar sua própria integração com a API Themes para importar e atualizar temas no Guide. Consulte os artigos sobre fluxo de trabalho, Theme Import Workflow e Theme Update Workflow, nos documentos do desenvolvedor da Zendesk.

Publicação do seu novo tema

Quando estiver pronto para publicar seu novo tema, clique em Publicar no menu de temas na bancada de trabalho.

Atualizações adicionais

Se você está usando sistemas de controle de versão como Git e Mercurial, continue a fazer as alterações localmente, não no Guide. Verifique suas alterações e importe o tema novamente no Guide. Se por engano você fizer alterações em seu tema no Guide, baixe o tema atualizado e verifique essas alterações no sistema de controle de código-fonte.

Importante: se você configurou uma integração com o GitHub, qualquer modificação feita em seu tema no Guide interromperá a integração com o GitHub.