Einrichten der GitHub-Integration mit Ihrem Guide-Design

Direktzugriff: Guide-Administrator > Symbol „Erscheinungsbild anpassen“ > Design hinzufügen > Aus GitHub hinzufügen

Anhand der GitHub-Integration können Sie in GitHub ein Design gemeinsam mit anderen entwickeln und pflegen und dann in Guide veröffentlichen. Stellen Sie vor dem Einrichten der Integration in Guide sicher, dass Ihr Design in GitHub gespeichert ist.

Hinweis: Die GitHub-Integration mit Ihrem Guide-Design bietet keine Unterstützung für GitHub Enterprise. Verwenden Sie stattdessen die Guide Theming API.

Die GitHub-Integration kann nur von einem Guide-Administrator in Guide eingerichtet werden.

In diesem Beitrag werden folgende Themen behandelt:

• Vorbereiten des Designs in GitHub
• Einrichten der Integration

Vorbereiten des Designs in GitHub

Bevor Sie die Integration in Guide einrichten, müssen Sie sicherstellen, dass das Design in GitHub gespeichert ist. Wenn Sie noch keine Erfahrung mit Git und GitHub haben, lesen Sie dieses Tutorial. Wenn das Design bereits in GitHub gespeichert ist und den folgenden Anforderungen entspricht, gehen Sie zu Einrichten der Integration in Guide.

Damit die Integration funktioniert, muss das zu verwendende GitHub-Repository folgende Anforderungen erfüllen:

• Die Manifestdatei muss sich auf der Root-Ebene des GitHub-Repositorys befinden

  Die Datei manifest.json muss auf der Root-Ebene des GitHub-Repositorys abgelegt sein, damit Guide das Design hinzufügen kann. Tools und andere zusätzliche Dateien, die ebenfalls dort gespeichert sind, werden beim Importieren in Guide einfach ignoriert.

• Das GitHub-Repository kann nur jeweils ein Design enthalten

  Sie können in jedem Repository nur jeweils ein Design verwalten. Beim Import des Designs können Sie mit der Branch-Option Variationen Ihres Designs ausprobieren.

So legen Sie Ihr Design in einem GitHub-Repository ab

• Wenn Sie noch kein Design haben, forken Sie das Repository mit dem Design „Copenhagen“ und beginnen Sie, das Design aufzubauen. Auf diese Weise können Sie künftig ganz einfach Verbesserungen aus dem Design „Copenhagen“ in Ihr Design übertragen.
• Wenn Ihr Design in Guide gespeichert ist, laden Sie Ihr Design aus Guide herunter, erstellen Sie ein GitHub-Repository (sofern noch nicht vorhanden) und kopieren Sie Ihr Design in das GitHub-Repository.
• Wenn Ihr Design nicht in Guide oder GitHub gespeichert ist, erstellen Sie ein GitHub-Repository (sofern noch nicht vorhanden) und kopieren Sie Ihr Design in das GitHub-Repository.

Nachdem Sie Ihr Design in GitHub vorbereitet haben, können Sie die Integration in Guide einrichten.

Einrichten der Integration

Um die GitHub-Integration einzurichten, müssen Sie sicherstellen, dass das Design in GitHub gespeichert ist. Dann können Sie es dann in Guide von GitHub abrufen. Durch diesen einmaligen Abruf wird die Verbindung zwischen dem Design und GitHub hergestellt.

Nachdem Sie die Integration eingerichtet haben, bearbeiten Sie das Design in GitHub und aktualisieren es dann in Guide. Anschließend können Sie in Guide eine Vorschau des Designs anzeigen und das Design veröffentlichen.

So richten Sie die GitHub-Integration mit Ihrem Guide-Design ein

1. Stellen Sie sicher, dass Sie Ihr Design in GitHub vorbereitet haben.
2. Klicken Sie in der Seitenleiste von Guide auf das Symbol Erscheinungsbild anpassen ().

   Die Seite „Designs“ wird geöffnet:

3. Klicken Sie oben rechts auf Design hinzufügen.
4. Klicken Sie auf Aus GitHub hinzufügen.

   

5. Geben Sie die URL für das Repository und optional einen Branch-Namen ein, wenn Sie das Design von einer anderen Branch als der Standard-Branch abrufen möchten. Klicken Sie dann auf Importieren.
6. Melden Sie sich bei GitHub an, wenn Sie dazu aufgefordert werden, und klicken Sie dann auf Authorize Zendesk.

Sobald der Importvorgang abgeschlossen ist, wird das Miniaturbild des Designs auf der Seite „Designs“ angezeigt. Wenn Sie Probleme haben, lesen Sie die Hinweise unter Beheben von Fehlern in der GitHub-Integration für Guide-Designs.

Nachdem Sie die Verbindung zwischen Ihrem Design in Guide und GitHub hergestellt haben, können Sie Ihr Design in GitHub verwalten und bei Bedarf in Guide aktualisieren.