Utilisation de vos propres ressources de thème pour le centre d’aide

Accès rapide : Admin Guide > Panneau de personnalisation > Sélectionner un thème > Modifier > Ressources

Vous pouvez télécharger des ressources, comme des images ou des fichiers, vers les thèmes de votre centre d’aide.

Cet article contient les sections suivantes :

• Téléchargement d’une ressource pour votre thème
• Utilisation des ressources téléchargées dans le code de votre thème
• Remplacement d’une ressource dans votre thème
• Suppression d’une ressource d’un thème

Téléchargement d’une ressource pour votre thème

Vous pouvez télécharger des ressources, tels des images ou des fichiers, vers le centre d’aide. Ces ressources sont stockées dans un cache Web, dans un réseau cloud (CDN). Les caches Web permettent de réduire l’utilisation de la bande passante et la charge du serveur, ce qui améliore les temps de réponse.

Divers types de fichiers sont autorisés pour les thèmes (consultez Types de fichiers autorisés pour les ressources des thèmes).

Pour télécharger vos propres ressources de thème

1. Dans Guide, cliquez sur l’icône du panneau de personnalisation () dans la barre latérale.
2. Cliquez sur Personnaliser sur le thème que vous voulez modifier.
3. Cliquez sur Modifier le code.

   

4. Dans la section Fichiers, cliquez sur Ajouter nouv., puis sélectionnez Ressource.

   

5. Naviguez pour sélectionner un fichier. Les noms de ressources de thème doivent être uniques et ne pas dépasser 50 caractères. Les noms des ressources peuvent contenir les caractères suivants : lettres, chiffres, points, signes moins et plus, tirets et traits de soulignement. Les noms des ressources ne sont pas sensibles à la casse, vous ne pouvez donc pas avoir une ressource appelée asset.jpg et une autre Asset.jpg.

   Le fichier de la ressource est ajouté à votre liste de fichiers de ressource.

Types de fichiers autorisés pour les ressources des thèmes

Le tableau suivant présente les types de fichiers autorisés pour les ressources des thèmes. Les types de fichiers autorisés pour les ressources sont limités aux types de fichiers utilisés dans les thèmes du centre d’aide.

Type de ressource	Types de fichiers autorisés
Images	jpg, jpeg, png, gif, svg, webp, tiff, tif, bmp, ico, webm
Polices	woff2, woff, eot, otf, ttf, svg
Fichiers texte	js, css, html, json, txt, xml
Autre	mp4, swf, wav, ogg. mp3

Les fichiers avec du contenu riche, comme les fichiers Microsoft PowerPoint, Microsoft Word et PDF, peuvent être utilisés pour les pièces jointes aux articles, mais pas pour les ressources des thèmes.

Utilisation des ressources téléchargées dans le code de votre thème

Vous pouvez faire référence à une ressource téléchargée dans le fichier style.css du thème ou dans ses modèles. Dans le fichier style.css, vous utilisez des variables de chemin de ressource fournies par Guide. Dans les modèles, vous utilisez l’assistant de ressource Curlybars.

En utilisant les assistants et les variables de ressource dans votre code, vous pouvez facilement remplacer les ressources dans votre thème sans modifier le code du thème. Consultez Remplacement d’une ressource dans votre thème.

Remarque – Vous ne pouvez pas utiliser les variables de chemin dans le fichier script.js du thème.

Pour utiliser une ressource téléchargée dans votre thème

1. Dans Guide, cliquez sur l’icône du panneau de personnalisation () dans la barre latérale.
2. Cliquez sur Personnaliser sur le thème que vous voulez modifier.
3. Cliquez sur Modifier le code.
4. Dans la section Ressources, cliquez sur le fichier de ressource que vous voulez utiliser.

   Diverses expressions pour la ressource s’affichent :

   

5. Cliquez sur Copier pour copier l’expression de la ressource dont vous avez besoin dans le presse-papiers.
6. Collez l’expression de la ressource dans le code de votre thème.

Exemples

style.css

.class-name { 
  background: url($assets-backpack2-jpeg);
}

La valeur assets-backpack2-jpeg est une variable qui contient le chemin relatif vers la ressource.

fichiers .hbs

Dans les balises HTML :

<img src="{{asset 'backpack2.jpeg'}}">

Dans une balise de style :

<style>
  .class-name { 
    background: url("{{asset 'backpack2.jpeg'}}");
  }
</style>

Dans une balise de script :

<script>
  var assetsBackpack2 = "{{asset 'backpack2.jpeg'}}";
</script>

Vous pouvez insérer l’assistant de ressource dans une balise de script dans un modèle, mais vous ne pouvez pas l’utiliser dans le fichier script.js.

Pour en savoir plus au sujet de la modification du code de votre thème, consultez Personnalisation du thème de votre centre d’aide.

Remplacement d’une ressource dans votre thème

En utilisant les assistants et les variables de ressource comme expliqué dans Utilisation des ressources téléchargées dans le code de votre thème ci-dessus, vous pouvez remplacer dynamiquement une ressource dans le thème sans modifier le code du thème. Pour mettre le thème à jour, il vous suffit de sélectionner un nouveau fichier de ressource dans votre système.

Pour remplacer une ressource

1. Dans Guide, cliquez sur l’icône du panneau de personnalisation () dans la barre latérale.
2. Cliquez sur Personnaliser sur le thème que vous voulez modifier.
3. Cliquez sur Modifier le code.
4. Dans la section Ressources, cherchez le fichier de ressource que vous voulez remplacer.
5. Cliquez sur le menu d’options à la fin du nom du fichier de ressource, puis sélectionnez Remplacer.

   

6. Sélectionnez une nouvelle ressource dans votre système.

   Une fois la ressource téléchargée, le thème est mis à jour dynamiquement par toute variable ou tout assistant faisant référence à la ressource. La modification est immédiate.

   La ressource n’est pas remplacée si vous avez utilisé l’URL complète de la ressource dans la source HTML des pages de centre d’aide publiées. Le lien vers la ressource ne fonctionne plus, car le remplacement d’une ressource change l’URL publiée de la ressource. Par conséquent, évitez d’utiliser l’URL publiée de la ressource dans les thèmes, les modèles de page ou les pages Web externes.

Suppression d’une ressource d’un thème

Il est facile de supprimer n’importe quelle ressource que vous n’utilisez plus dans votre thème.

Pour supprimer une ressource d’un thème

1. Dans Guide, cliquez sur l’icône du panneau de personnalisation () dans la barre latérale.
2. Cliquez sur Personnaliser sur le thème que vous voulez modifier.
3. Cliquez sur Modifier le code.

   

4. Dans la section Ressources, cherchez le fichier de ressource que vous voulez supprimer.
5. Cliquez sur le menu d’options à la fin du nom du fichier de ressource, puis sélectionnez Supprimer la ressource.

   

6. Confirmez que vous souhaitez supprimer la ressource.

   La ressource est supprimée de votre liste de ressources.