Você também pode trabalhar em um tema localmente no editor de código da sua preferência e visualizar suas alterações em tempo real em um navegador. Não é necessário carregar os arquivos no Guide toda vez que você deseja visualizar suas alterações. Um processo é executado em segundo plano no seu computador e carrega as alterações sempre que você salva um arquivo localmente.
Exemplo:
Os tópicos abordados neste artigo são:
Configuração da visualização local de temas
A configuração da visualização local de temas consiste em baixar arquivos de temas, permitir o acesso à API na sua conta e instalar a interface de linha de comando do Zendesk (ZCLI) no seu computador. A ZCLI permite a visualização local de temas.
Como configurar a visualização local de temas
- Baixe e descompacte os arquivos de temas do Guide em uma pasta de trabalho.
Consulte Download de um tema da central de ajuda.
- Se você ainda não fez isso, permita que a API acesse a sua conta do Zendesk.
Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione APIs > API do Zendesk. - Instale a ZCLI. Consulte Installing and updating ZCLI (Instalação e uso da ZCLI) na documentação do desenvolvedor da Zendesk.
Ativação da visualização local de temas
Você deve ativar a visualização local de temas antes de começar a trabalhar nos arquivos de temas em seu computador.
Como ativar a visualização local de temas
- No terminal da linha de comando do computador, navegue até a pasta que contém os arquivos de temas baixados e descompactados. Exemplo:
cd guide_themes/newlook_theme - Entre na conta do Zendesk em que você baixou o tema.
zcli login -iNas solicitações, insira o seu subdomínio, e-mail e senha:
Use o subdomínio do Zendesk padrão da sua conta para entrar. Não utilize subdomínios mapeados de host.
Se você usa single sign-on (SSO) para fazer login no Zendesk, pode entrar usando um token da API. Insira o seu_email/token do seu nome de usuário, onde "/token" é efetivamente a cadeia de caracteres "/token". Use o token da API como sua senha. Exemplo:Email: jdoe@example.com/token Password: e8Pvy0pvGzE8meUQxWgjIYkjr - Inicie o processo de visualização local em segundo plano:
zcli themes:previewO comando da ZCLI é iniciado na visualização local e carrega o tema local no modo de pré-visualização na sua central de ajuda. As alterações feitas nos arquivos localmente impactarão o tema no modo de pré-visualização.
- Copie e cole a URL de "Ready" em um navegador como o Chrome ou o Firefox.
O navegador precisa permitir conteúdo misto de HTTP e HTTPS. O Safari não oferece suporte a conteúdo misto nem permite que você visualize os temas localmente.
A URL de “Ready” tem esse formato https://seusubdominio.zendesk.com/hc/admin/local_preview/start.
Para obter mais informações sobre o comando de pré-visualização da ZCLI, consulte zcli themes no GitHub.
Visualização de alterações
Depois que a ZCLI carrega o seu tema no modo de pré-visualização na central de ajuda, você pode trabalhar nos arquivos do tema localmente usando seu editor de código preferido e visualizar as alterações no navegador. Trabalhe iterativamente para desenvolver e testar seu tema. Por exemplo, faça algumas alterações em um arquivo, salve e confira as alterações no navegador. Corrija quaisquer erros antes de fazer outras alterações.
Como visualizar alterações
- Salve os arquivos editados no seu editor de código.
- Confira os resultados no tema no modo de pré-visualização no navegador.
O tema é recarregado automaticamente no navegador depois que você salvar um arquivo localmente. Não é necessário recarregar a página.
A ZCLI permite desativar o recarregamento em tempo real. Consulte zcli themes no GitHub.
Ao terminar, você pode interromper a pré-visualização usando um dos métodos a seguir:
- Na sessão do terminal que está executando a ZCLI, pressione Ctrl+C.
- Abra https://yoursubdomain.zendesk.com/hc/admin/local_preview/stop no seu navegador, com seu subdomínio atual na URL.
- Na parte superior da página de visualização do tema do navegador, clique no link Fechar visualização.