La creación de plantillas de Guide renderiza los paquetes de temas del centro de ayuda que contienen el lenguaje de plantillas Curlybars que se usa en los archivos de plantillas, los archivos CSS y JS, así como en el archivo de manifiesto.
La creación de plantillas de Guide también se conoce con el nombre de API de creación de plantillas.
Para obtener más información sobre los temas del centro de ayuda, consulte Personalización del tema del centro de ayuda y la documentación sobre la API de creación de plantillas.
Acerca de las versiones de creación de plantillas de Guide
La tabla siguiente presenta las versiones de creación de plantillas de Guide, las fechas de publicación y los vínculos a la página de documentación para programadores donde hay información específica sobre lo que cada versión tiene disponible.
Para verificar qué versión está usando, consulte Verificar la versión de creación de plantillas.
| Versión | Fecha de publicación | Página de documentación para programadores |
|---|---|---|
| 1 | 20 de noviembre de 2014 | NO APLICA |
| 2 | 24 de febrero de 2020 | Upgrading from templating API v1 (Actualización de la API de creación de plantillas v1) |
| 3 | 1 de junio de 2023 | Upgrading from templating API v2 (Actualización de la API de creación de plantillas v2) |
| 4 | 2 de julio de 2024 | Upgrading from templating API v3 (Actualización de la API de creación de plantillas v3) |
Verificar la versión de creación de plantillas
Podrá ver la versión de creación de plantillas al editar el tema o visualizar el archivo de manifiesto.
Para verificar la versión de creación de plantillas
-
En la interfaz Administrador de Conocimiento, haga clic en el icono Personalizar diseño (
) en la barra lateral. - En el tema que desea ver, haga clic en Personalizar.
- Haga clic en Editar código.
- Bajo el nombre del tema, verá el número de la versión de creación de plantillas, por ejemplo, “Templating API v2”.
Este número de versión corresponde al campo
api_versionen el archivo de manifiesto.
Actualizar la versión de creación de plantillas
Si ha personalizado el tema de su centro de ayuda, puede actualizar a la versión de creación de plantillas más reciente para aprovechar las nuevas funciones, un rendimiento superior y mejoras relacionadas con la accesibilidad.
Al hacer la migración desde una experiencia de temas, se aplicarán algunas nuevas restricciones a los temas. Durante el proceso de migración, se suspenden algunos tipos de archivo y algunas limitaciones de tamaño para permitir la transferencia del tema y los recursos a la nueva experiencia de temas donde será más fácil trabajar con ellos.
Por ejemplo, si hay varios archivos PDF u otros archivos que ya no se admiten en los recursos de temas, se puede migrar el tema. A continuación, podrá exportar el tema para recuperar todos los archivos fácilmente. No obstante, no podrá duplicar ni volver a importar el tema mientras no se eliminen del tema los archivos no compatibles.
Para actualizar la versión de creación de plantillas
- Descargue el tema del centro de ayuda, consulte Descargar un tema del centro de ayuda.
- Abra el paquete del tema localmente y edite el archivo manifest.json.
- En el archivo manifest.json, ubique el campo
api_versiony cambie el valor a la versión a la cual desea actualizar. - Haga una vista previa local de los cambios del tema. Cuando haga una vista previa del tema, recibirá advertencias si está usando helpers obsoletos en la versión a la cual está actualizando.
- Si está usando un helper obsoleto, consulte la documentación para programadores relacionada (consulte Acerca de las versiones de creación de plantillas de Guide) para reemplazar el helper con un equivalente que sea admitido.
Vuelva a hacer una vista previa de su tema para comprobar que no hay más advertencias.
- Cargue el tema actualizado en Guide (consulte Importación del tema del centro de ayuda).
Si desea comprobar si efectivamente se ha aplicado la nueva versión, puede verificar la versión de creación de plantillas.