Vista previa local de los cambios del tema

Es posible exportar los archivos del tema de Guide y se puede trabajar con los archivos sin conexión en cualquier editor. Para no tener que comprimir e importar los archivos en Guide cada vez que desee previsualizar los cambios, puede previsualizar cada cambio localmente en un navegador web con las herramientas de aplicaciones de Zendesk (ZAT). Para previsualizar un cambio, solo hay que guardar el archivo del tema en el editor de escritorio y volver 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. Observe la interfaz de línea de comando en la parte inferior de la imagen.

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 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 las herramientas de aplicaciones de Zendesk (ZAT).

   Consulte Installing and using the Zendesk apps tools en el centro de ayuda para programadores.

3. Si ya instaló ZAT para crear aplicaciones de Zendesk, no deje de actualizarlo ejecutando el siguiente comando en la interfaz de línea de comando:

   $ gem update zendesk_apps_tools

Para instalar ZAT y usarlo se necesita una interfaz de línea de comando (CLI). En macOS, se puede usar Terminal en la carpeta Aplicaciones/Utilidades. En Windows, se puede usar la línea de comando o Powershell. Los usuarios de Windows 10, pueden instalar y usar una shell bash, una CLI para programadores más fácil de usar. Consulte Setting up a Bash shell in Windows 10.

Iniciar la vista previa local del tema

Se debe iniciar 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 interfaz de línea de comando, vaya a la carpeta que contiene los archivos del tema exportados y descomprimidos.

   Utilice el comando cd (para cambiar el directorio) para ir a una carpeta secundaria. Ejemplo:

   $ cd guide_themes/newlook_theme

   Para volver a un directorio anterior, utilice cd seguido de un espacio y dos puntos. Ejemplo:

   cd ..

2. Ejecute el siguiente comando:

   $ zat theme preview 

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

   

   El subdominio y el correo electrónico se guardan en un archivo de texto denominado .zat en la carpeta del tema, para que solo tenga que ingresar su contraseña la próxima vez que inicie el modo de previsualización. Si se equivocó al ingresar su nombre de usuario o contraseña, borre el archivo .zat y vuelva a comenzar. Tenga en cuenta que los archivos que tienen puntos iniciales están ocultos en macOS de manera predeterminada. Consulte Show Hidden Files in Mac OS X en el sitio web osxdaily.com.

   Si utiliza el inicio de sesión único (SSO) para iniciar sesión en Guide (por ejemplo, usando las credenciales de Google o Microsoft), puede iniciar sesión usando un token de API que se puede obtener en la interfaz de administrador de Support. 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 verdadero 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.

   En el ejemplo, el URL es https://nadosolutions.zendesk.com/hc/admin/local_preview/start.

   Se carga una página sin formato después del inicio de sesión. Los navegadores modernos tienen una función de seguridad que no deja que ciertos archivos locales (conocidos como contenido mixto) se carguen en una página. La función se puede desactivar en Chrome y Firefox como se describe en el paso siguiente.

5. En Chrome o Firefox, haga clic en el icono de escudo en la barra de direcciones y acepte cargar un script no seguro (Chrome) o desactivar la protección en la página (Firefox). En Firefox, el icono de escudo se encuentra al lado izquierdo de la barra de direcciones.

   

   Nota: Safari no tiene una opción para desactivar la protección. Debe usar Chrome o Firefox para previsualizar.

   La página con el formato correcto debería cargarse automáticamente. Puede comenzar a editar los archivos de temas en el editor y previsualizar localmente en el navegador.

Previsualizar los cambios

Después de iniciar el modo de vista previa del tema, puede trabajar con los archivos del tema en su editor preferido. 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.
2. Vuelva a cargar la página del navegador.

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

• Vaya al navegador y haga clic en el vínculo "Para salir, haga clic aquí" en la parte superior de la página previsualizada.
• Cambie a la interfaz de línea de comando y presione Control+C.