Trabalho local em um tema

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

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

1. Criação de um novo tema adicionando o tema Copenhagen ou duplicando um tema existente.
2. Download do 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 novamente 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. Você também pode obter uma versão mais recente do tema no repositório Copenhagen de código aberto 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 um tema existente, consulte Adição de um tema da central de ajuda ao Guide.

Download do seu tema

Agora você já pode baixar o seu tema no Guide. Um 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 o 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 a importação dos arquivos para o Guide toda vez que desejar ver suas alterações, você pode visualizar essas alterações localmente em um navegador. Para configurar a visualização local de temas, consulte Visualização local de alterações do tema.

Depois de configurada, você pode visualizar as alterações localmente salvando os arquivos em que estiver trabalhando. O tema é recarregado automaticamente no navegador. Assim, você pode trabalhar iterativamente fazendo alterações nos modelos, CSS, JavaScript e ativos antes de visualizar os resultados do seu trabalho.

Além disso, quando você baixa um tema para sua máquina local, recomendamos que ele seja colocado em seu repositório de controle de versão favorito (Git, Mercurial ou SVN).

Sua equipe também pode desenvolver e manter o tema colaborativamente usando o GitHub, para visualização e publicação posteriores na mesma ferramenta. 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 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 e importar um arquivo ZIP separado. Consulte Atualização do seu tema gerenciado pelo GitHub no Guide.

Outra opção é construir a sua própria integração com a API de temas para importar e atualizar temas no Guide. Consulte Theme Import Workflow (Fluxo de trabalho de importação de temas) e Theme Update Workflow (Fluxo de trabalho de atualização de temas) nos documentos do desenvolvedor do Zendesk.

Publicação do seu novo tema

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

Alterações adicionais

Se você usa os sistemas de controle de versão como Git ou Mercurial, continue fazendo as alterações localmente, não no Guide. Verifique suas alterações e importe o tema novamente no Guide. Se você fez alterações por acidente no seu tema no Guide, baixe o tema atualizado e verifique essas alterações no seu sistema de controle de origem.

Importante: se você configurou uma integração com o GitHub, essas modificações no seu tema no Guide interrompem a integração com o GitHub.