Les fonctionnalités de thèmes les plus puissantes de Guide sont les capacités d’importation, de téléchargement et de travail en local sur les thèmes. Quand vous effectuez des mises à jour importantes d’un thème ou en créez un de zéro, ces options permettent aux développeurs de profiter d’un workflow rationalisé.
Le workflow de création d’un nouveau thème ou de mise à jour d’un thème existant est le suivant :
- Commencez un nouveau thème en ajoutant le thème Copenhagen ou en dupliquant un thème existant.
- Téléchargez votre thème pour travailler hors ligne.
- Modifiez votre thème en local avec vos propres outils de développement.
- Réimportez votre thème dans Guide.
- Publiez votre nouveau thème.
- Effectuez toute mise à jour supplémentaire.
Commencez un nouveau thème
Si vous créez un nouveau thème de zéro, envisagez de commencer à partir d’une nouvelle version du thème Copenhagen standard. Pour ce faire, ajoutez un nouveau thème et une nouvelle copie du thème Copenhagen est ajoutée à votre page Thèmes. Vous pouvez aussi obtenir une nouvelle version du thème à partir du référentiel Copenhagen open source sur GitHub.
La plupart des gens préfèrent commencer avec un thème existant, quitte à y apporter d’importantes modifications pour créer leur propre thème. Si vous retravaillez un thème existant et souhaitez conserver certains styles, vous pouvez dupliquer le thème.
Pour commencer un nouveau thème en ajoutant une nouvelle copie du thème Copenhagen ou en copiant un thème existant, consultez Ajout d’un thème de centre d’aide à Guide.
Téléchargement de votre thème
Vous voilà prêt à télécharger votre thème depuis Guide. Un thème est téléchargé sous la forme d’une archive zip contenant modèles, JavaScript, CSS et documents. Cela vous permet de travailler sur le thème à l’extérieur de Guide, avec vos propres outils de développement.
Pour télécharger votre thème, consultez Téléchargement d’un thème de votre centre d’aide.
Modifiez votre thème en local
Vous voilà prêt à commencer à travailler sur votre machine locale, avec vos propres outils de développement.
Pour éviter d’avoir à compresser et importer les fichiers dans Guide chaque fois que vous voulez voir un aperçu de vos modifications, vous pouvez consulter un aperçu de chaque modification dans votre navigateur Web en utilisant ZAT. L’objectif de l’aperçu local est de permettre aux développeurs de travailler avec des outils qu’ils connaissent bien et ainsi de créer des thèmes rapidement et facilement. Pour configurer l’aperçu du thème ZAT, consultez Aperçu des modifications des thèmes en local.
Une fois le mode d’aperçu lancé, vous pouvez modifier les fichiers de thème dans votre éditeur de texte préféré. L’aperçu en local a une fonction de rechargement en direct. Les changements que vous apportez aux fichiers actualisent automatiquement l’aperçu. D’ici, vous pouvez rapidement modifier modèles, CSS, JavaScript et documents.
En outre, une fois que vous avez téléchargé un thème sur votre machine locale, il est conseillé de l’enregistrer dans votre référentiel de contrôle de version préféré, comme Git, Mercurial, SVN, etc.
Votre équipe peut aussi développer et maintenir un thème de façon collaborative en utilisant GitHub, puis en afficher l’aperçu et le publier à partir de GitHub. Consultez Configuration de l’intégration GitHub avec votre thème Guide.
Réimportez votre thème
Une fois que vous avez développé le thème en local, compressez le répertoire du thème dans une archive zip et importez-le dans Guide en le faisant glisser et en le déposant sur la page Thèmes ou en utilisant l’option d’importation.
Cela importe le thème sous la forme d’un nouveau thème personnalisé. Vous pouvez le visualiser dans Guide et les autres utilisateurs de votre organisation peuvent également le voir.
Pour importer votre thème, consultez Importation d’un thème de votre centre d’aide.
Si vous configurez une intégration avec GitHub, vous pouvez mettre un thème à jour dans Guide depuis GitHub. Vous n’avez pas besoin de créer une archive ZIP séparée et de l’importer. Consultez Mise à jour de votre thème géré par GitHub dans Guide.
Une autre option est de développer votre propre intégration avec l’API Thèmes pour importer et mettre à jour les thèmes dans Guide. Consultez Workflow d’importation des thèmes et Workflow de mise à jour des thèmes dans la documentation Zendesk pour les développeurs.
Publiez votre nouveau thème
Quand vous êtes prêt à publier votre thème, cliquez sur Publier dans le menu Thème.
Effectuez toute mise à jour supplémentaire
Si vous utilisez des systèmes de contrôle de version comme git ou mercurial, continuez à effectuer vos modifications en local, pas dans Guide. Enregistrez vos modifications et importez à nouveau le thème dans Guide. Si vous modifiez votre thème dans Guide par inadvertance, téléchargez le thème mis à jour et enregistrez ces modifications dans votre système de contrôle de sources.
0 Commentaires
Vous devez vous connecter pour laisser un commentaire.