Vista previa local de los cambios del tema

Puede exportar los archivos de un tema de Guide y trabajar en los archivos sin conexión en su editor de texto preferido. Para no tener que comprimir e importar los archivos en Guide cada vez que desee previsualizar los cambios, puede previsualizar cada cambio con las herramientas de aplicaciones de Zendesk (ZAT). Para previsualizar un cambio, guarde el archivo del tema en el editor de escritorio y vuelva a cargar la página del navegador. Ejemplo:

ZAT es una colección de herramientas de desarrollo que incluye Sinatra, un servidor web que se ejecuta localmente en el equipo. Una vez iniciado el modo de previsualización, el proceso se ejecuta en segundo plano.

Nota: La interfaz de línea de comando de Zendesk (ZCLI) reemplaza a ZAT para el desarrollo de aplicaciones, pero todavía no admite vistas previas para los temas de Zendesk Guide.

Temas que se tratan en este artículo:

• Configurar la vista previa local del tema
• Iniciar la vista previa local del tema
• Previsualizar los cambios

Configurar la vista previa local del tema

Para instalar y usar ZAT, debe activar el acceso a la API y configurar un entorno de desarrollo local.

Para configurar la vista previa local del tema

1. Si aún no lo ha hecho, active el acceso a la API en su cuenta de Zendesk Support a través de Administrador > Canales > API.
2. Instale ZAT. Consulte Installing and using ZAT (Instalar y usar ZAT) en la documentación para desarrolladores de Zendesk. Luego regrese aquí.
3. Actualice ZAT ejecutando el siguiente comando en la terminal del equipo:

   gem update zendesk_apps_tools

Iniciar la vista previa local del tema

Inicie la vista previa local del tema antes de comenzar a trabajar con los archivos del tema en el equipo.

Para iniciar la vista previa local del tema

1. En la terminal del equipo, vaya a la carpeta que contiene los archivos del tema exportados y descomprimidos. Ejemplo:

   cd guide_themes/newlook_theme

2. Ejecute el siguiente comando:

   zat theme preview 

3. Cuando se le indique, ingrese el subdominio de su cuenta de Zendesk, además del correo electrónico y la contraseña que usa para iniciar sesión en Zendesk Guide.

   

   Si utiliza el inicio de sesión único (SSO) para iniciar sesión en Guide, puede iniciar sesión usando un token de API. Consulte token de API en la documentación de la API de REST. Cuando ZAT le indique que inicie sesión, ingrese {su_correo electrónico}/token como su nombre de usuario, donde "/token" es la cadena "/token” en sí. Utilice el token de API como su contraseña. Ejemplo:

   Enter your username: [e-mail]/token
   Enter your password: e8Pvy0pvGzE8meUQxWgjIYkjr

   Una vez que se haya iniciado sesión, se iniciará el modo de previsualización y se ejecutará en segundo plano:

   

4. Copie el URL "Ready" de la salida y péguelo en un navegador web, como Chrome o Firefox. El navegador tiene que permitir contenido mixto de HTTP y HTTPS. Safari no admite contenido mixto y no le permitirá previsualizar los temas localmente.

   En el ejemplo, el URL "Ready" es https://z3n-example.zendesk.com/hc/admin/local_preview/start.

   El URL debería cargar la vista previa del tema.

Previsualizar los cambios

Después de iniciar el modo de vista previa del tema, puede trabajar con los archivos del tema localmente en el editor de texto. Trabaje de manera iterativa para crear y probar el tema. Por ejemplo, haga algunos cambios en el JavaScript, guarde los cambios, y luego vuelva a cargar la página del navegador para probar los cambios.

Para previsualizar los cambios

1. Guarde el archivo editado en el editor de texto.
2. Vuelva a cargar la página del navegador.

Cuando termine, puede detener el modo de vista previa usando uno de los siguientes métodos:

• En la sesión de la terminal que ejecuta ZAT, presione Ctrl+C.
• En la parte superior de la página de vista previa del tema del navegador, haga clic en el vínculo Cerrar vista previa.