What's my plan?
Suite Growth, Professional, Enterprise, or Enterprise Plus
Support with Guide Professional or Enterprise

Riepilogo AI verificato ◀▼

Integra il tema del centro assistenza con GitHub per collaborare allo sviluppo del tema e gestirlo in un unico luogo. Prepara il tema in GitHub, assicurandoti che soddisfi requisiti come la presenza di un file manifest nella radice. Configura l’integrazione in Amministratore Knowledge importando il tema da GitHub. Gestisci gli aggiornamenti in GitHub e pubblicali quando sono pronti.

Posizione: Amministratore Knowledge > Personalizza design () > Aggiungi tema > Aggiungi da GitHub

L’integrazione GitHub ti permette di sviluppare e gestire un tema in modo collaborativo in GitHub, quindi di pubblicarlo in anteprima in Amministratore Knowledge. Per configurare l’integrazione, assicurati che il tema sia memorizzato in GitHub, quindi configura l’integrazione in Amministratore Knowledge.

Nota: l’integrazione GitHub con il Centro assistenza non supporta GitHub Enterprise Server, ma supporta GitHub Enterprise Cloud. Se usi GitHub Enterprise Server, in alternativa puoi usare l’API dei temi Guide.

Devi essere un amministratore Guide per configurare l’integrazione GitHub.

Questo articolo include i seguenti argomenti:
  • Preparazione del tema in GitHub
  • Come impostare l’integrazione

Preparazione del tema in GitHub

Prima di configurare l’integrazione nell’amministratore Knowledge, devi assicurarti che il tema sia 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.

L’integrazione ha i seguenti requisiti per il repository GitHub:

  • Il file manifest deve trovarsi nella radice del repository GitHub

    Per 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 Amministratore Knowledge.

  • 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 tuo tema è in Amministratore Knowledge, scarica il tema, quindi crea un repository GitHub (se non ne hai già uno) e invia il tema al repository GitHub.
  • Se il tuo tema non è in Amministratore Knowledge 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.

Come impostare l’integrazione

Per configurare l’integrazione GitHub, assicurati che il tema sia memorizzato in GitHub, quindi recuperalo da GitHub in Amministratore Knowledge. Questo recupero una tantum stabilisce il collegamento tra il tema e GitHub.

Dopo aver configurato l’integrazione, lavorerai sul tema in GitHub, quindi aggiornerai il tema in Amministratore Knowledge quando lo desideri. Puoi quindi visualizzare in anteprima o pubblicare il tema in Amministratore Knowledge.

Come configurare l’integrazione GitHub con il tema del centro assistenza

  1. In GitHub, assicurati di aver preparato il tema.
  2. In Amministratore Knowledge, fai clic su Personalizza design () nella barra laterale.

    A questo punto si apre la pagina Temi.

  3. Fai clic su Aggiungi tema nell’angolo in alto a destra.
  4. Fai clic su Aggiungi da GitHub.

  5. 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.
  6. 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 per i temi del centro assistenza.

Dopo aver stabilito la connessione, gestirai il tema in GitHub e aggiornerai il tema in Amministratore Knowledge, se necessario.

Powered by Zendesk