Vous pouvez télécharger des documents, tels des images ou des fichiers, vers les thèmes de votre centre d’aide.
Téléchargement d’un document pour votre thème
Vous pouvez télécharger des documents, tels des images ou des fichiers, vers le centre d’aide. Ces documents sont stockés 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 documents des thèmes).
Pour télécharger vos propres documents de thème
- Dans Guide, cliquez sur l’icône du panneau de personnalisation (
) dans la barre latérale. - Cliquez sur Personnaliser sur le thème que vous voulez modifier.
- Cliquez sur Modifier le code.
- Dans la section Fichiers, cliquez sur Ajouter nouv., puis sélectionnez Document.
-
Naviguez pour sélectionner un fichier. Les noms de documents de thème doivent être uniques et ne pas dépasser 50 caractères. Les noms des documents peuvent contenir les caractères suivants : lettres, chiffres, points, signes moins et plus, tirets et traits de soulignement. Les noms des documents ne sont pas sensibles à la casse, vous ne pouvez donc pas avoir un document appelé asset.jpg et un autre Asset.jpg.
Le fichier du document est ajouté à votre liste de fichiers de document.
Types de fichiers autorisés pour les documents des thèmes
Le tableau suivant présente les types de fichiers autorisés pour les documents des thèmes. Les types de fichiers autorisés pour les documents sont limités aux types de fichiers utilisés dans les thèmes du centre d’aide.
| Type de document | 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 documents des thèmes.
Utilisation des documents téléchargés dans le code de votre thème
Vous pouvez faire référence à un document téléchargé 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 document fournies par Guide. Dans les modèles, vous utilisez l’assistant de document Curlybars.
En utilisant les assistants et les variables de document dans votre code, vous pouvez facilement remplacer les documents dans votre thème sans modifier le code du thème. Consultez Remplacement d’un document dans votre thème.
Pour utiliser un document téléchargé dans votre thème
- Dans Guide, cliquez sur l’icône du panneau de personnalisation () dans la barre latérale.
- Cliquez sur Personnaliser sur le thème que vous voulez modifier.
- Cliquez sur Modifier le code.
- Dans la section Documents, cliquez sur le fichier de document que vous voulez utiliser.
Diverses expressions pour le document s’affichent :
- Cliquez sur Copier pour copier l’expression du document dont vous avez besoin dans le presse-papiers.
- Collez l’expression du document 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 le document
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 document 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’un document dans votre thème
En utilisant les assistants et les variables de document comme expliqué dans Utilisation des documents téléchargés dans le code de votre thème ci-dessus, vous pouvez remplacer dynamiquement un document 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 document dans votre système.
- Dans Guide, cliquez sur l’icône du panneau de personnalisation () dans la barre latérale.
- Cliquez sur Personnaliser sur le thème que vous voulez modifier.
- Cliquez sur Modifier le code.
- Dans la section Documents, cherchez le fichier de document que vous voulez remplacer.
- Cliquez sur le menu d’options à la fin du nom du fichier de document, puis sélectionnez Remplacer.
- Sélectionnez un nouveau document dans votre système.
Une fois le document téléchargé, le thème est mis à jour dynamiquement par toute variable ou tout assistant faisant référence au document. La modification est immédiate.
Le document n’est pas remplacé si vous avez utilisé l’URL complète du document dans la source HTML des pages de centre d’aide publiées. Le lien vers le document ne fonctionne plus, car le remplacement d’un document change l’URL publiée du document. Par conséquent, évitez d’utiliser l’URL publiée du document dans les thèmes, les modèles de page ou les pages Web externes.
Suppression d’un document d’un thème
Il est facile de supprimer n’importe quel document que vous n’utilisez plus dans votre thème.
Pour supprimer un document d’un thème
- Dans Guide, cliquez sur l’icône du panneau de personnalisation () dans la barre latérale.
- Cliquez sur Personnaliser sur le thème que vous voulez modifier.
- Cliquez sur Modifier le code.
- Dans la section Documents, cherchez le fichier de document que vous voulez supprimer.
- Cliquez sur le menu d’options à la fin du nom du fichier de document, puis sélectionnez Supprimer l’actif.
- Confirmez que vous souhaitez supprimer le document.
Le document est supprimé de votre liste de documents.
0 Commentaires
Vous devez vous connecter pour laisser un commentaire.