Pubblica articoli su GitLab

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

Prima di iniziare#

• Piano: la pubblicazione su GitLab è 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 GitLab. Una volta connesso, chiunque possa modificare un articolo può pubblicarlo.
• Solo GitLab.com: Clevera si connette a GitLab.com. I server GitLab gestiti autonomamente non sono supportati.
• Ruolo in GitLab: Clevera elenca i progetti in cui l'account che effettua la connessione ha il ruolo di Developer o superiore. Per eseguire il commit su un branch predefinito protetto, tale account solitamente deve avere il ruolo di Maintainer (vedi Branch protetti).
• 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 GitLab#

1. Apri Integrazioni#

   Nella barra laterale, apri il menu dell'area di lavoro e scegli Integrazioni. Trova GitLab sotto Integrazioni disponibili (o nella scheda Sviluppo) e clicca su Connetti.

2. Accedi a GitLab e autorizza#

   Accedi a GitLab.com se non l'hai già fatto. GitLab ti chiederà di autorizzare Clevera con i seguenti ambiti:

   Ambito GitLab	Perché
   api	L'API dei file di GitLab ne ha bisogno per creare e aggiornare i file
   read_user	Per mostrare il tuo nome utente GitLab in Clevera
   read_repository	Per verificare se un file esiste già
   write_repository	Per eseguire il commit del file Markdown e delle sue immagini

   Clicca su Autorizza.

3. Verifica la connessione#

   Tornerai a Integrazioni con il messaggio "GitLab connesso correttamente a" seguito dal tuo nome utente GitLab. GitLab si sposterà nell'elenco Connesso con un badge Connesso. Prima di pubblicare qualsiasi cosa, leggerai "Nessun elemento ancora pubblicato".

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 GitLab 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 il progetto e la cartella#

   Sotto Dove viene salvato, scegli:

   Campo	Cosa scegliere	Note
   Repository	Il progetto GitLab per il file	Progetti in cui sei Developer o superiore, ordinati per aggiornamento recente. Il primo è selezionato per te
   Cartella	Un percorso come docs o articles/guides	"Il file Markdown viene creato qui. Lascia vuoto per la root del repository." Inizia come docs. Le cartelle che non esistono ancora verranno create

   Clevera ricorderà la tua scelta per la prossima volta.

   

3. Pubblica#

   Clicca su Pubblica su GitLab. Vedrai "Ricerca di una copia esistente in GitLab", poi Scrittura della pagina. Al termine, vedrai "Pubblicato su GitLab." Clicca su Apri in GitLab 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 progetto (solitamente main). Clevera esegue il commit direttamente su di esso; non apre una merge request e non puoi scegliere un altro branch.
• Nome del file: il titolo in minuscolo, con gli spazi sostituiti da trattini, che termina con .md. "Create your first invoice" diventa create-your-first-invoice.md. I titoli in altri alfabeti o con accenti vengono traslitterati in caratteri latini ("Créer une facture" diventa creer-une-facture.md). Un titolo che non può essere traslitterato, come uno composto solo da emoji, riceve un breve codice fisso (article- più 8 caratteri). I nomi vengono troncati a 80 caratteri.
• Immagini: gli screenshot dell'articolo finiscono 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 GitLab che ha connesso l'integrazione.

Branch protetti#

GitLab protegge il branch predefinito per impostazione predefinita e solitamente solo i Maintainer possono eseguire il push su di esso. Se l'account connesso è un Developer, il commit viene rifiutato con "GitLab ha rifiutato il commit: è necessario l'accesso Developer o superiore e il branch non deve essere protetto." Assegna a quell'account il ruolo di Maintainer oppure consenti ai Developer di eseguire il push in Impostazioni → Repository → Branch protetti nel progetto.

Aspetto del file#

Clevera scrive in Markdown che GitLab è in grado di visualizzare, con un breve blocco di 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 progetto accanto al file e i link Markdown puntano ad essi tramite percorso relativo (assets/<file name>/…). Continuano a funzionare senza Clevera e, in un progetto privato, rimangono privati quanto il resto del progetto.

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#

Se GitLab Pages o un altro generatore di siti statici (come MkDocs, Docusaurus o Hugo) crea la tua documentazione dal progetto, imposta Cartella sulla cartella che legge. Ogni pubblicazione è un commit normale, quindi la tua pipeline viene eseguita come al solito. La maggior parte dei generatori legge title dal front matter e ignora i campi che non conosce.

Aggiorna un articolo già pubblicato#

La pubblicazione è unidirezionale. Le modifiche apportate in Clevera rimangono in Clevera finché non pubblichi di nuovo, e le modifiche apportate al file in GitLab non vengono mai riportate in Clevera.

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

Se il titolo è cambiato in Clevera, anche il nome del file cambia, quindi la pubblicazione crea un nuovo file accanto a quello vecchio. Elimina o rinomina tu stesso il vecchio file in GitLab. Nulla in Clevera elimina file dal tuo progetto.

Disconnetti GitLab#

1. Apri Integrazioni, clicca sul menu ⋯ sulla riga di GitLab e scegli Disconnetti (oppure clicca su GitLab e poi su Disconnetti).
2. Conferma. "Non puoi più pubblicare su di esso dall'editor. Il contenuto che hai già pubblicato rimane in GitLab."

La disconnessione elimina i token di Clevera. Per revocare l'accesso di Clevera anche su GitLab, apri il menu dell'avatar di GitLab → Modifica profilo → Applicazioni, trova Clevera sotto Applicazioni autorizzate e clicca su Revoca.

Risoluzione dei problemi#

Correlati#