Pubblica articoli su Bitbucket

Connetti Bitbucket una volta sola e potrai pubblicare qualsiasi articolo Clevera in un repository Bitbucket come file Markdown, pronto per un sito di documentazione o una docs/ cartella accanto al tuo codice. 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 Bitbucket è 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 dello spazio di lavoro o un amministratore può connettere o disconnettere Bitbucket. Una volta connesso, chiunque possa modificare un articolo può pubblicarlo.
• Solo Bitbucket Cloud: Clevera si connette a bitbucket.org. Bitbucket Data Center e Server non sono supportati.
• Accesso in Bitbucket: l'account che effettua la connessione deve avere i permessi per contribuire ai repository in cui vuoi pubblicare, con accesso in scrittura al branch principale.
• Un articolo: pubblichi l'articolo associato a un video o a una registrazione. Generalo prima; vedi Trasforma una registrazione in un articolo.

La pubblicazione non utilizza crediti.

Connetti Bitbucket#

1. Apri Integrazioni#

   Nella barra laterale, apri il menu dello spazio di lavoro e scegli Integrazioni. Trova Bitbucket sotto Integrazioni disponibili (o nella scheda Sviluppo) e clicca su Connetti.

2. Concedi l'accesso in Bitbucket#

   Accedi a Bitbucket se non l'hai già fatto. Bitbucket ti chiederà di concedere a Clevera l'accesso:

   Permesso Bitbucket	Perché
   Account: lettura	Per mostrare il tuo nome Bitbucket in Clevera
   Repository: lettura	Per elencare i repository e verificare se un file esiste già
   Repository: scrittura	Per eseguire il commit del file Markdown e delle sue immagini

   Clicca su Concedi accesso.

3. Verifica la connessione#

   Tornerai a Integrazioni con il messaggio "Bitbucket connesso correttamente a" seguito dal tuo nome Bitbucket. Bitbucket 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 Bitbucket 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 repository e la cartella#

   Sotto Dove viene salvato, scegli:

   Campo	Cosa scegliere	Note
   Repository	Il repository Bitbucket per il file	Repository a cui puoi contribuire, tra i tuoi spazi di lavoro Bitbucket, ordinati per data di aggiornamento. Il primo è selezionato automaticamente
   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 Bitbucket. Vedrai "Ricerca di una copia esistente in Bitbucket", poi Scrittura della pagina. Al termine, vedrai "Pubblicato su Bitbucket". Clicca su Apri in Bitbucket 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 principale del repository (solitamente main o master). Clevera esegue il commit direttamente su di esso; non apre una pull request e non puoi scegliere un altro branch.
• Nome del file: il titolo in minuscolo, con gli spazi sostituiti da 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 caratteri latini ("Créer une facture" diventa creer-une-facture.md). Un titolo senza caratteri traslitterabili, 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 Bitbucket che ha connesso l'integrazione.

Restrizioni sui branch#

Se il repository ha una restrizione sul branch principale (ad esempio, modifiche consentite solo tramite pull request o scrittura limitata a determinate persone), il commit di Clevera verrà rifiutato, ad esempio con "You need write access to commit to this Bitbucket repository." Aggiungi l'account connesso tra le persone autorizzate a scrivere sul branch in Impostazioni repository → Restrizioni branch, oppure pubblica in un repository senza tale regola.

Com'è fatto il file#

Clevera scrive in Markdown semplice che la visualizzazione file di Bitbucket può mostrare, con un breve blocco front matter in alto. Non contiene HTML grezzo, poiché Bitbucket non lo renderizza.

---
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 salvati 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 salvato nel repository. Rimane un link a Clevera che scade dopo un po'; pubblica di nuovo per rinnovarlo.

Usalo con un sito di documentazione#

Se un generatore di siti statici (come MkDocs, Docusaurus o Hugo) crea la tua documentazione dal repository, punta Cartella alla cartella che legge. Ogni pubblicazione è un normale commit, quindi Bitbucket Pipelines o gli altri processi di build vengono eseguiti 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 che apporti in Clevera rimangono in Clevera finché non pubblichi di nuovo, e le modifiche apportate al file in Bitbucket non tornano mai in Clevera.

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

Se il titolo è cambiato 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 in Bitbucket. Nulla in Clevera elimina file dal tuo repository.

Disconnetti Bitbucket#

1. Apri Integrazioni, clicca sul menu ⋯ nella riga di Bitbucket e scegli Disconnetti (o clicca su Bitbucket e poi su Disconnetti).
2. Conferma. "Non potrai più pubblicare da esso tramite l'editor. Il contenuto già pubblicato rimane in Bitbucket."

La disconnessione elimina i token di Clevera. Per revocare l'accesso di Clevera anche su Bitbucket, apri le tue Impostazioni personali di Bitbucket, vai su Autorizzazioni app e revoca Clevera.

Risoluzione dei problemi#

Correlati#