Acerca de las versiones de creación de plantillas de Guide

La creación de plantillas de Guide procesa los paquetes de temas del Centro de ayuda. Esto incluye el lenguaje de plantillas Curlybars que se usa en los archivos de plantillas, los archivos CSS y JS, y el archivo de manifiesto.

La creación de plantillas de Guide también se conoce como la API de creación de plantillas.

Para obtener más información sobre las plantillas de Guide, consulte Personalización del tema del Centro de ayuda y la documentación para desarrolladores sobre las plantillas para el Centro de ayuda.

En este artículo se tratan los siguientes temas:

• Acerca de las versiones de creación de plantillas de Guide
• Verificar la versión de creación de plantillas
• Actualizar de la versión 1 de creación de plantillas de Guide a la versión 2

Acerca de las versiones de creación de plantillas de Guide

La API de creación de plantillas v2 salió el 24 de febrero de 2020, y esta versión se aplica al tema Copenhagen y a todas las nuevas versiones del tema.

Si ha personalizado su tema, puede seguir usando la API de creación de plantillas v1 y no tiene que actualizar a la versión 2 salvo que desee aprovechar las nuevas funciones y el mejor rendimiento. Puede verificar cuál versión del framework está usando en Guide (consulte Verificar la versión de creación de plantillas).

Con la versión 2, ya no se pueden usar las declaraciones jQuery en ninguna parte del tema donde se podría usar JavaScript estándar (como script.js o document_head.hbs). Si desea usar jQuery con la versión 2, tendrá que importar la biblioteca de jQuery.

También hemos descontinuado algunos helpers y cambiado otros, para generar objetos de datos en lugar de HTML. Encontrará una lista completa aquí.

Verificar la versión de creación de plantillas

Puede ver la versión de creación de plantillas en la vista Editar código en su tema o en el archivo de manifiesto.

Para verificar la versión de creación de plantillas

1. En Guide, haga clic en el icono Personalizar diseño () en la barra lateral.
2. En el tema que desea ver, haga clic en Personalizar.
3. Haga clic en Editar código.
4. Bajo el nombre del tema, verá el número de la versión, por ejemplo, API de creación de plantillas v2.

   

   Este número de versión corresponde al campo api_version en el archivo de manifiesto.

Actualizar de la versión 1 de creación de plantillas de Guide a la versión 2

Si ha personalizado su tema de Guide, puede actualizar a la versión 2 para aprovechar las nuevas funciones y el mayor rendimiento.

Para actualizar la versión de creación de plantillas

1. Descargue su tema del Centro de ayuda (consulte Descargar un tema del Centro de ayuda).
2. Abra el paquete del tema localmente y edite el archivo manifest.json.
3. En el archivo manifest.json, busque el campo api_version y cambie el valor a 2.
4. Previsualice los cambios en el tema localmente. Cuando previsualice el tema, recibirá advertencias si está usando los helpers que se descontinuaron en la versión 2.
5. Si está usando un helper descontinuado, utilice esta información para reemplazar el helper con uno equivalente que esté admitido.

   Vuelva a previsualizar su tema para asegurarse de que no haya ninguna otra advertencia.

6. Cargue el tema actualizado en Guide (consulte Importar un tema del Centro de ayuda).

   Para verificar si se ha aplicado la nueva versión, puede verificar la versión de creación de plantillas.