L’integrazione GitHub ti permette di sviluppare e gestire un tema in modo collaborativo in GitHub, quindi di pubblicarlo in anteprima in Guide. Per configurare l’integrazione, assicurati che il tema sia memorizzato in GitHub, quindi configura l’integrazione in Guide.
Devi essere un amministratore Guide per configurare l’integrazione GitHub in Guide.
Preparazione del tema in GitHub
Prima di configurare l’integrazione in Guide, devi assicurarti che il tema sia presente in GitHub. Se non conosci Git e GitHub, consulta questo tutorial. Se il tema è già presente in GitHub e soddisfa i seguenti requisiti, consulta Configurazione dell’integrazione in Guide.
L’integrazione ha i seguenti requisiti per il repository GitHub:
-
Il file manifest deve trovarsi nella radice del repository GitHub
Per consentire a Guide di aggiungere il tema, il file manifest.json deve essere posizionato nella radice del repository GitHub. Puoi comunque includere file aggiuntivi, come gli strumenti, che vengono ignorati durante l’importazione in Guide.
-
Il repository GitHub può avere un solo tema
Devi gestire un solo tema in ciascun repository. Puoi usare l’opzione per i branch durante l’importazione del tema per provare le diverse varianti.
Per inserire il tuo tema in un repository GitHub
- Se al momento non disponi di un tema, esegui il fork del repository del tema Copenhagen e inizia a creare il tema. Ciò ti consente di trasferire facilmente i miglioramenti dal tema Copenhagen al tuo tema in futuro.
- Se il tema è in Guide, scaricalo da Guide, quindi crea un repository GitHub (se non ne hai già uno) e invia il tema al repository GitHub.
- Se il tuo tema non è in Guide o GitHub, crea un repository GitHub (se non ne hai già uno) e invia il tema al repository GitHub.
Dopo aver preparato il tema in GitHub, sei pronto per configurare l’integrazione in Guide.
Come impostare l’integrazione
Per configurare l’integrazione GitHub, assicurati che il tema sia memorizzato in GitHub, quindi recuperalo da GitHub in Guide. Questo recupero una tantum stabilisce il collegamento tra il tema e GitHub.
Dopo aver configurato l’integrazione, potrai lavorare sul tema in GitHub, quindi aggiornare il tema in Guide quando lo desideri. In Guide potrai quindi visualizzare in anteprima il tema attivo o pubblicarlo.
Per configurare l’integrazione GitHub con il tema di Guide
- In GitHub, assicurati di aver preparato il tema.
- In Guide, fai clic sull’icona Personalizza aspetto (
) nella barra laterale.
A questo punto si apre la pagina Temi.
- Fai clic su Aggiungi tema nell’angolo in alto a destra.
- Fai clic su Aggiungi da GitHub.
- Inserisci l’URL del repository e, facoltativamente, il nome di un branch se vuoi recuperarlo da un branch diverso da quello predefinito, quindi fai clic su Importa.
- Se richiesto, accedi a GitHub, quindi fai clic su Autorizza Zendesk.
La miniatura del tema viene visualizzata nella pagina Temi al termine dell’importazione. In caso di problemi, consulta Risoluzione dei problemi relativi all’integrazione Github con i temi di Guide.
Dopo aver stabilito la connessione tra il tema in Guide e GitHub, potrai gestire il tema in GitHub e aggiornare il tema in Guide in base alle esigenze.