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 des mises à jour supplémentaires.
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 vous procurer une nouvelle version du thème dans le référentiel Copenhagen en 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 existants, 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 ressources. 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 des modifications dans votre navigateur Web. Pour configurer l’aperçu des thèmes en local, consultez Aperçu des modifications des thèmes en local.
Une fois cette option configurée, vous pouvez afficher l’aperçu des modifications en local en enregistrant les fichiers sur lesquels vous travaillez. Le thème se recharge automatiquement dans votre navigateur. Cela vous permet de travailler de façon itérative, en modifiant les modèles, les fichiers CSS, JavaScript et les ressources, puis en affichant les résultats de votre travail.
En outre, quand vous téléchargez 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é (Git, Mercurial ou SVN).
Votre équipe peut aussi développer et maintenir un thème de façon collaborative dans GitHub, puis en afficher l’aperçu ou le publier dans Guide à 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 à jour un thème dans Guide depuis GitHub. Vous n’avez pas à créer une archive ZIP indépendante et à l’importer. Consultez Mise à jour de votre thème géré par GitHub dans Guide.
Une autre option est de créer votre propre intégration avec l’API Thèmes pour mettre à jour et importer les thèmes dans Guide. Consultez les sections sur le workflow d’importation des thèmes et le workflow de mise à jour des thèmes dans la documentation destinée aux développeurs Zendesk.
Publiez votre nouveau thème
Quand vous êtes prêt à publier votre thème, cliquez sur Publier dans le menu Thème.
Effectuez des mises à jour supplémentaires
Si vous utilisez des systèmes de contrôle des versions comme Git ou Mercurial, continuez d’effectuer vos modifications en local, pas dans Guide. Enregistrez vos modifications et réimportez le thème dans Guide. Si vous modifiez votre thème dans Guide accidentellement, téléchargez le thème mis à jour et enregistrez ces modifications dans votre système de contrôle.