Pubblica articoli su GitHub

Connetti GitHub una volta sola e potrai pubblicare qualsiasi articolo Clevera in un repository come file Markdown, pronto per un sito di documentazione, una cartella in stile wiki docs/ o una raccolta di README. Questo articolo spiega come connettersi, scegliere il repository e la cartella, l'aspetto del file e come funzionano gli aggiornamenti.

Prima di iniziare#

• Piano: la pubblicazione su GitHub è inclusa nei piani Pro e Custom. Nei piani Free e Starter, la scheda Pubblica mostra "La pubblicazione sui tuoi strumenti è inclusa nel piano Pro". Vedi Scegli un piano.
• Ruolo in Clevera: solo il proprietario dell'area di lavoro o un Amministratore può connettere o disconnettere GitHub. Una volta connesso, chiunque possa modificare un articolo può pubblicarlo.
• Accesso in GitHub: la persona che effettua la connessione deve avere l'accesso in scrittura ai repository in cui desideri pubblicare e il diritto di installare un'app GitHub su quell'account personale o organizzazione (o un proprietario dell'organizzazione deve approvarla).
• Un articolo: pubblichi l'articolo che appartiene a un video o a una registrazione. Generalo prima; vedi Trasforma una registrazione in un articolo.

La pubblicazione non utilizza crediti.

Connetti GitHub#

1. Apri Integrazioni#

   Nella barra laterale, apri il menu dell'area di lavoro e scegli Integrazioni. Trova GitHub sotto Integrazioni disponibili (o nella scheda Sviluppo) e clicca su Connetti. Il pulsante appare quando punti il cursore sulla scheda.

   

2. Autorizza Clevera su GitHub#

   GitHub ti chiederà di autorizzare l'app Clevera AI. Richiede l'accesso in lettura alle tue appartenenze alle organizzazioni, in modo che Clevera possa elencare gli account a cui appartieni. Clicca su Autorizza.

3. Installa l'app sui tuoi repository#

   GitHub aprirà quindi la pagina di installazione dell'app Clevera AI. Scegli il tuo account personale o un'organizzazione, quindi seleziona Tutti i repository o Solo repository selezionati. L'app richiede:

   Autorizzazione GitHub	Perché
   Contenuti: lettura e scrittura	Per creare e aggiornare il file Markdown e le sue immagini
   Metadati: sola lettura	Richiesto da GitHub per ogni app; consente a Clevera di elencare i repository

   Clicca su Installa. Ripeti l'operazione per ogni organizzazione in cui desideri pubblicare.

4. Verifica la connessione#

   Tornando su Integrazioni, GitHub si sposta nell'elenco Connesso con il nome del tuo account GitHub o dell'organizzazione e un badge Connesso. Prima di pubblicare qualsiasi cosa, leggerai "Nessun contenuto pubblicato".

   

Aggiungi o rimuovi repository in seguito#

Clevera vede solo i repository su cui è installata l'app. Per modificare questa impostazione, apri Integrazioni, clicca su GitHub e sotto Accesso clicca su Accesso al repository. Su GitHub, apri l'account, clicca su Configura e modifica l'elenco dei repository. I nuovi repository appariranno la prossima volta che aprirai la scheda Pubblica.

Pubblica un articolo#

1. Apri la scheda Pubblica#

   Nell'editor, clicca su Condividi e apri la scheda Pubblica. Sotto Pubblica l'articolo, clicca sul riquadro GitHub sotto Pronto per la pubblicazione.

   L'articolo viene pubblicato nella lingua che hai aperto nell'editor. Cambia lingua nella barra superiore prima di pubblicare una traduzione.

2. Scegli l'account, il repository e la cartella#

   Sotto Destinazione, scegli:

   Campo	Cosa scegliere	Note
   Profilo	Il tuo account personale o un'organizzazione	Mostrato solo quando i tuoi repository appartengono a più di un account
   Repository	Il repository per il file	I più recenti per primi. Il primo è selezionato per te
   Cartella	Un percorso come docs o articles/guides	"Il file Markdown viene creato qui. Lascialo vuoto per la root del repository." Inizia come docs. Le cartelle che non esistono ancora vengono create

   Clevera ricorderà la tua scelta per la prossima volta.

   

3. Pubblica#

   Clicca su Pubblica su GitHub. Vedrai "Ricerca di una copia esistente su GitHub", poi Scrittura della pagina. Al termine, vedrai "Pubblicato su GitHub". Clicca su Apri in GitHub per vedere il file.

   Puoi chiudere la finestra Condividi mentre l'operazione è in corso; una notifica ti avviserà quando sarà completata.

Dove va il file#

• Branch: il branch predefinito del repository (solitamente main). Clevera esegue il commit direttamente su di esso; non apre una pull request e non puoi scegliere un altro branch.
• Nome file: il titolo in minuscolo, con gli spazi trasformati in trattini, terminante in .md. "Create your first invoice" diventa create-your-first-invoice.md. I titoli in altri alfabeti o con accenti vengono traslitterati in lettere latine ("Créer une facture" diventa creer-une-facture.md). Un titolo senza caratteri traslitterabili, come uno composto solo da emoji, ottiene un breve codice fisso (article- più 8 caratteri). I nomi vengono troncati a 80 caratteri.
• Immagini: gli screenshot dell'articolo vanno in assets/<file name>/ all'interno della stessa cartella, nello stesso commit.
• Messaggio di commit: Add article: <title>, o Update article: <title> quando aggiorni un file esistente.
• Autore del commit: l'account GitHub che ha connesso l'integrazione.

Aspetto del file#

Clevera scrive in Markdown in stile GitHub con un breve blocco front matter all'inizio:

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

Il video da cui proviene l'articolo non viene aggiunto al file. Un video Clevera inserito nell'articolo diventa un link al suo player, solo quando il link di condivisione del video è attivo. Vedi Mostra un video in un articolo.

Immagini#

Gli screenshot vengono sottoposti a commit nel tuo repository accanto al file e il Markdown li collega tramite percorso relativo (assets/<file name>/…). Continuano a funzionare senza Clevera e, in un repository privato, rimangono privati quanto il resto del contenuto.

Un file video caricato nell'articolo non viene sottoposto a commit. Rimane un link a Clevera che scade dopo un po'; pubblica di nuovo per rinnovarlo.

Usalo con un sito di documentazione#

La maggior parte dei generatori di siti statici che creano da un repository (come Docusaurus, MkDocs, Jekyll o Hugo) legge title dal front matter e ignora i campi che non conosce. Una configurazione comune:

1. Punta la Cartella alla cartella che il tuo sito di documentazione legge, ad esempio docs o content/guides.
2. Pubblica ogni articolo lì; la build normale del tuo sito rileverà il nuovo commit.
3. Verifica se il tuo generatore renderizza gli avvisi GitHub, la matematica e <details>; alcuni mostrano gli avvisi come semplici citazioni.

Aggiorna un articolo già pubblicato#

La pubblicazione è unidirezionale. Le modifiche che apporti in Clevera rimangono in Clevera finché non pubblichi di nuovo, e le modifiche apportate al file su GitHub non tornano mai in Clevera.

Quando pubblichi nello stesso repository e nella stessa cartella, Clevera trova il file con lo stesso nome e mostra "Questo articolo è già presente su GitHub". Clicca su Visualizzalo per aprire il file esistente, quindi scegli:

Se il titolo cambia in Clevera, cambia anche il nome del file, quindi la pubblicazione crea un nuovo file accanto a quello vecchio. Elimina o rinomina tu stesso il vecchio file su GitHub.

Nessuna operazione in Clevera elimina file dal tuo repository.

Disconnetti GitHub#

1. Apri Integrazioni, clicca sul menu ⋯ nella riga di GitHub e scegli Disconnetti (oppure clicca su GitHub e poi su Disconnetti).
2. Conferma. "Non potrai più pubblicare da qui dall'editor. I contenuti già pubblicati rimarranno su GitHub."

La disconnessione elimina il token di accesso di Clevera. Per rimuovere anche l'accesso di Clevera su GitHub, disinstalla l'app Clevera AI (GitHub Impostazioni → Applicazioni → App GitHub installate → Configura → Disinstalla) e revoca l'autorizzazione sotto App GitHub autorizzate.

Risoluzione dei problemi#

Correlati#