Es posible cargar recursos como imágenes y archivos en cualquiera de los temas del centro de ayuda.
Cargar un recurso para un tema
Puede cargar recursos como imágenes y archivos al centro de ayuda. Los recursos se guardan en una memoria caché en la web en una red de entrega en la nube (CDN). Las memorias caché en la web reducen los requisitos de ancho de banda y la carga del servidor, y mejoran los tiempos de respuesta.
Hay varios tipos de archivos permitidos para los temas (consulte Tipos de archivo permitidos para los recursos de los temas).
Para cargar sus propios recursos de temas
- En Guide, haga clic en el icono Personalizar diseño () en la barra lateral.
- En el tema que desea editar, haga clic en Personalizar.
- Haga clic en Editar código.
- En la sección Archivos, haga clic en Agregar nuevo y seleccione Activo.
-
Busque y seleccione su archivo. Los nombres de los recursos de temas deben ser únicos y no pueden tener más de 50 caracteres. Dichos nombres pueden contener lo siguiente: letras, números, puntos, signos de menos y más, carácter de subrayado y guion. Los nombres de recursos no distinguen entre mayúsculas y minúsculas, así que no se puede tener un recurso llamado asset.jpg y otro Asset.jpg.
El archivo de recursos se agrega a la lista de archivos de recursos.
Tipos de archivo permitidos para los recursos de los temas
En la tabla siguiente se muestran los tipos de archivo que se permiten como recursos de los temas. Los tipos de archivo permitidos para los recursos se limitan a los tipos de archivo que se usan en la creación de temas de un centro de ayuda.
Tipo de recurso | Tipos de archivo permitidos |
---|---|
Imágenes | jpg, jpeg, png, gif, svg, webp, tiff, tif, bmp, ico, webm |
Fuentes | woff2, woff, eot, otf, ttf, svg |
Archivos de texto | js, css, html, json, txt, xml |
Otro | mp4, swf, wav, ogg. mp3 |
Los tipos de archivo de contenido enriquecido, como Microsoft PowerPoint, Microsoft Word y PDF, pueden ser adjuntos de artículos pero no pueden ser recursos de un tema.
Utilizar recursos ya cargados en el código del tema
Puede hacer referencia a un recurso ya cargado en el archivo style.css del tema o en sus plantillas. En style.css, se usan las variables de la ruta de acceso al recurso proporcionadas por Guide. En las plantillas, se usa el helper de recursos de Curlybars.
Si se usan helpers y variables de recursos en el código, los recursos del tema se pueden reemplazar fácilmente sin necesidad de editar su código. Consulte Reemplazar un recurso en un tema.
Para usar un recurso ya cargado en el código del tema
- En Guide, haga clic en el icono Personalizar diseño () en la barra lateral.
- En el tema que desea editar, haga clic en Personalizar.
- Haga clic en Editar código.
- En la sección Recursos, haga clic en el archivo de recurso que desea usar.
Aparecen varias expresiones para el recurso:
- Haga clic en Copiar para copiar la expresión del recurso al portapapeles.
- Pegue la expresión del recurso en el código del tema.
Ejemplos
style.css
.class-name {
background: url($assets-backpack2-jpeg);
}
El valor assets-backpack2-jpeg
es una variable que contiene la ruta de acceso relativa al recurso.
archivos .hbs
En el marcado HTML:
<img src="{{asset 'backpack2.jpeg'}}">
En una etiqueta style:
<style>
.class-name {
background: url("{{asset 'backpack2.jpeg'}}");
}
</style>
En una etiqueta script:
<script>
var assetsBackpack2 = "{{asset 'backpack2.jpeg'}}";
</script>
Si bien es posible insertar el helper de recursos en una etiqueta script en una plantilla, no se puede usar en el archivo script.js.
Si desea más información sobre cómo editar el código del tema, consulte Personalización del tema del centro de ayuda.
Reemplazar un recurso en un tema
El uso de helpers y variables de recursos como se describe en Utilizar recursos ya cargados en el código del tema más arriba, permite reemplazar un recurso en el tema de manera dinámica sin necesidad de editar el código del tema. El tema se puede actualizar con solo seleccionar un nuevo archivo de recursos en el sistema.
- En Guide, haga clic en el icono Personalizar diseño () en la barra lateral.
- En el tema que desea editar, haga clic en Personalizar.
- Haga clic en Editar código.
- En la sección Recursos, ubique el archivo de recursos que desea reemplazar.
- Haga clic en el menú de opciones al final del nombre del archivo del recurso y luego seleccione Reemplazar.
- Seleccione un nuevo recurso en el sistema.
Una vez cargado, el tema es actualizado de manera dinámica por cualquier variable o helper que haga referencia al recurso. El cambio es inmediato.
El recurso no se reemplaza si se utilizó el URL completo del recurso en la fuente de HTML de las páginas publicadas del centro de ayuda. El vínculo al recurso se rompe porque cuando se reemplaza un recurso se cambia el URL publicado del recurso. Por este motivo se recomienda evitar usar el URL del recurso publicado en un tema, una plantilla de página o una página web externa.
Borrar un recurso de tema
Es fácil borrar algún recurso de tema que ya no esté usando en su tema.
Para borrar un recurso de tema
- En Guide, haga clic en el icono Personalizar diseño () en la barra lateral.
- En el tema que desea editar, haga clic en Personalizar.
- Haga clic en Editar código.
- En la sección Recursos, ubique el archivo de recursos que desea borrar.
- Haga clic en el menú de opciones al final del nombre del archivo del recurso y luego seleccione Borrar recurso.
- Confirme que desea borrar el recurso.
El recurso se borra de la lista de recursos.