Dépannage de l’intégration GitHub avec les thèmes Guide

Cet article couvre les messages d’erreur pour l’intégration GitHub pour les thèmes Guide, ainsi que les étapes de dépannage permettant de résoudre un problème ou de mettre un thème à jour.

Vous devez être un administrateur Guide pour gérer l’intégration GitHub dans Guide.

Cet article aborde les sujets suivants :

• Échec d’importation du thème
• Échec de la mise à jour du thème
• Vérifiez que vous avez accès au référentiel
• Vérifiez que l’application Zendesk Guide est autorisée
• Numéro de version du thème incorrect
• Le numéro de version du thème n’est pas autorisé
• Autorisation impossible avec Internet Explorer

Échec d’importation du thème

• Vérifiez que vous avez écrit l’URL du référentiel GitHub correctement ou [username]/[repository] correctement. Il est conseillé de copier et coller l’URL du référentiel à partir de la barre d’adresse quand vous consultez le référentiel.

• Si vous effectuez la récupération à partir d’une branche spécifique, vérifiez que vous avez écrit le nom de la branche correctement.
• Vérifiez que vous avez accès au référentiel
• Vérifiez que l’application Zendesk Guide est autorisée

Échec de la mise à jour du thème

• Vérifiez que vous avez accès au référentiel
• Vérifiez que l’application Zendesk Guide est autorisée

Vérifiez que vous avez accès au référentiel

Vérifiez que vous avez accès au référentiel en allant à https://github.com/settings/repositories. Si vous ne voyez pas le référentiel, c’est soit parce que votre accès a été révoqué, soit parce que le référentiel a été supprimé. Contactez l’administrateur du référentiel pour en savoir plus.

• Si votre accès a été révoqué, vous devrez demander à l’administrateur du référentiel de vous l’accorder à nouveau.

• Si le référentiel a été supprimé, vous ne pouvez pas mettre le thème à jour ni le connecter à un autre référentiel. Vous devrez lancer une nouvelle importation à partir d’un référentiel qui existe.

Vérifiez que l’application Zendesk Guide est autorisée

Vérifiez que l’application Zendesk Guide est autorisée pour votre compte dans GitHub. Allez à https://github.com/settings/applications et vérifiez que l’application Zendesk Guide a accès à votre compte dans l’onglet des applications autorisées par OAuth.

Si l’application Zendesk Guide ne se trouve pas dans les applications autorisées par OAuth, cela peut être parce que :

• L’autorisation pour l’application Zendesk Guide GitHub a été révoquée et vous devez à nouveau l’autoriser. Vous pouvez le faire en mettant à nouveau votre thème à jour ou, si cela ne fonctionne pas, en essayant d’ajouter le thème en tant que nouveau thème puis de mettre à jour le thème que vous essayiez de mettre à jour.

• L’organisation GitHub à laquelle le référentiel appartient n’autorise pas l’autorisation de l’application Zendesk Guide. Dans ce cas, contactez l’administrateur de l’organisation GitHub pour qu’il autorise l’autorisation de l’application Zendesk Guide pour la portée du référentiel. C’est la seule portée que fournit GitHub qui donne accès au code du référentiel, il n’est donc pas possible d’autoriser une portée plus petite.

Numéro de version du thème incorrect

Le numéro de version du thème dans le fichier manifest.json doit être incrémenté car il est différent du numéro de version actuel. Incrémentez le numéro de version du thème ou demandez au développeur du thème de le faire pour vous.

Le numéro de version du thème n’est pas autorisé

Le numéro de version du thème dans le fichier manifest.json ne respecte pas les conventions de numéros de version. Demandez au développeur du thème de corriger le numéro de version du thème pour qu’il soit en conformité avec ces conventions.

Autorisation impossible avec Internet Explorer

Vous ne pouvez pas effectuer l’authentification avec Internet Explorer car GitHub ne prend plus ce navigateur en charge. Vous pouvez effectuer l’authentification en utilisant un autre navigateur pris en charge par GitHub et Zendesk, comme Google Chrome, Firefox ou Safari.