Publier des articles sur Bitbucket

Connectez Bitbucket une fois et vous pourrez publier n'importe quel article Clevera vers un dépôt Bitbucket sous forme de fichier Markdown, prêt pour un site de documentation ou un dossier docs/ à côté de votre code. Cet article couvre la connexion, le choix du dépôt et du dossier, l'apparence du fichier et le fonctionnement des mises à jour.

Avant de commencer#

• Forfait : la publication sur Bitbucket fait partie des forfaits Pro et Custom. Sur les forfaits Free et Starter, l'onglet Publier affiche "La publication vers vos outils est incluse dans le forfait Pro". Voir Choisir un forfait.
• Rôle dans Clevera : seul le propriétaire de l'espace de travail ou un administrateur peut connecter ou déconnecter Bitbucket. Une fois connecté, toute personne pouvant modifier un article peut le publier.
• Bitbucket Cloud uniquement : Clevera se connecte à bitbucket.org. Bitbucket Data Center et Server ne sont pas pris en charge.
• Accès dans Bitbucket : le compte utilisé pour la connexion doit pouvoir contribuer aux dépôts sur lesquels vous souhaitez publier, avec un accès en écriture sur la branche principale.
• Un article : vous publiez l'article qui appartient à une vidéo ou à un enregistrement. Générez-le d'abord ; voir Transformer un enregistrement en article.

La publication n'utilise aucun crédit.

Connecter Bitbucket#

1. Ouvrir les Intégrations#

   Dans la barre latérale, ouvrez le menu de l'espace de travail et choisissez Intégrations. Trouvez Bitbucket sous Intégrations disponibles (ou l'onglet Développement) et cliquez sur Connecter.

2. Accorder l'accès dans Bitbucket#

   Connectez-vous à Bitbucket si ce n'est pas déjà fait. Bitbucket vous demande d'accorder l'accès à Clevera :

   Autorisation Bitbucket	Pourquoi
   Compte : lecture	Pour afficher votre nom Bitbucket dans Clevera
   Dépôts : lecture	Pour lister les dépôts et vérifier si un fichier existe déjà
   Dépôts : écriture	Pour valider (commit) le fichier Markdown et ses images

   Cliquez sur Accorder l'accès.

3. Vérifier la connexion#

   Vous revenez dans Intégrations avec le message "Bitbucket connecté avec succès à" suivi de votre nom Bitbucket. Bitbucket passe dans la liste Connecté avec un badge Connecté. Avant de publier quoi que ce soit, il est indiqué "Rien n'a encore été publié".

Publier un article#

1. Ouvrir l'onglet Publier#

   Dans l'éditeur, cliquez sur Partager et ouvrez l'onglet Publier. Sous Publier l'article, cliquez sur la tuile Bitbucket sous Prêt à publier.

   L'article est publié dans la langue que vous avez ouverte dans l'éditeur. Changez de langue dans la barre supérieure avant de publier une traduction.

2. Choisir le dépôt et le dossier#

   Sous Destination, choisissez :

   Champ	Que choisir	Notes
   Dépôt	Le dépôt Bitbucket pour le fichier	Dépôts auxquels vous pouvez contribuer, dans vos espaces de travail Bitbucket, classés par date de mise à jour. Le premier est sélectionné par défaut
   Dossier	Un chemin tel que docs ou articles/guides	"Le fichier Markdown est créé ici. Laissez vide pour la racine du dépôt." Commence par docs. Les dossiers qui n'existent pas encore sont créés

   Clevera mémorise votre choix pour la prochaine fois.

   

3. Publier#

   Cliquez sur Publier sur Bitbucket. Vous verrez "Recherche d'une copie existante dans Bitbucket", puis Écriture de la page. Une fois terminé, vous verrez "Publié sur Bitbucket". Cliquez sur Ouvrir dans Bitbucket pour voir le fichier.

   Vous pouvez fermer la fenêtre Partager pendant l'opération ; une notification vous informera une fois terminée.

Où va le fichier#

• Branche : la branche principale du dépôt (généralement main ou master). Clevera valide directement dessus ; il n'ouvre pas de demande de tirage (pull request) et vous ne pouvez pas choisir une autre branche.
• Nom du fichier : le titre en minuscules, avec les espaces remplacés par des tirets, se terminant par .md. "Create your first invoice" devient create-your-first-invoice.md. Les titres dans d'autres écritures ou avec des accents sont d'abord transcrits en lettres latines ("Créer une facture" devient creer-une-facture.md). Un titre sans caractère transposable, comme un titre composé uniquement d'émojis, reçoit un court code fixe (article- plus 8 caractères). Les noms sont coupés à 80 caractères.
• Images : les captures d'écran de l'article vont dans assets/<file name>/ au sein du même dossier, dans la même validation.
• Message de validation : Add article: <title>, ou Update article: <title> lorsque vous mettez à jour un fichier existant.
• Auteur de la validation : le compte Bitbucket qui a connecté l'intégration.

Restrictions de branche#

Si le dépôt a une restriction de branche sur sa branche principale (par exemple, modifications uniquement via des demandes de tirage, ou écritures limitées à certaines personnes), la validation de Clevera est refusée, par exemple avec "Vous avez besoin d'un accès en écriture pour valider sur ce dépôt Bitbucket." Ajoutez le compte connecté aux personnes pouvant écrire sur la branche sous Paramètres du dépôt → Restrictions de branche, ou publiez sur un dépôt sans cette règle.

À quoi ressemble le fichier#

Clevera écrit du Markdown brut que la vue de fichier de Bitbucket peut afficher, avec un court bloc de métadonnées (front matter) en haut. Il ne contient pas de HTML brut, car Bitbucket ne le rend pas.

---
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"
---

La vidéo dont provient l'article n'est pas ajoutée au fichier. Une vidéo Clevera placée dans l'article devient un lien vers son lecteur, uniquement lorsque le lien de partage de cette vidéo est activé. Voir Afficher une vidéo dans un article.

Images#

Les captures d'écran sont validées dans votre dépôt à côté du fichier, et le Markdown y renvoie par un chemin relatif (assets/<file name>/…). Elles continuent de fonctionner sans Clevera, et dans un dépôt privé, elles restent aussi privées que le reste du contenu.

Un fichier vidéo que vous avez téléchargé dans l'article n'est pas validé. Il reste un lien vers Clevera qui expire après un certain temps ; publiez à nouveau pour le renouveler.

Utilisation avec un site de documentation#

Si un générateur de site statique (tel que MkDocs, Docusaurus ou Hugo) construit votre documentation à partir du dépôt, pointez Dossier vers le dossier qu'il lit. Chaque publication est une validation normale, donc Bitbucket Pipelines ou vos autres builds s'exécutent comme d'habitude. La plupart des générateurs lisent title depuis les métadonnées et ignorent les champs qu'ils ne connaissent pas.

Mettre à jour un article déjà publié#

La publication ne fonctionne que dans un sens. Les modifications que vous apportez dans Clevera restent dans Clevera jusqu'à ce que vous publiiez à nouveau, et les changements apportés au fichier dans Bitbucket ne reviennent jamais dans Clevera.

Lorsque vous publiez sur le même dépôt et le même dossier, Clevera trouve le fichier portant le même nom et affiche "Cet article est déjà dans Bitbucket." Cliquez sur Le voir pour ouvrir le fichier existant, puis choisissez :

Si le titre a changé dans Clevera, le nom du fichier change également, donc la publication crée un nouveau fichier à côté de l'ancien. Supprimez ou renommez vous-même l'ancien fichier dans Bitbucket. Rien dans Clevera ne supprime de fichiers de votre dépôt.

Déconnecter Bitbucket#

1. Ouvrez Intégrations, cliquez sur le menu ⋯ sur la ligne Bitbucket et choisissez Déconnecter (ou cliquez sur Bitbucket puis sur Déconnecter).
2. Confirmez. "Vous ne pouvez plus publier dessus depuis l'éditeur. Le contenu que vous avez déjà publié reste dans Bitbucket."

La déconnexion supprime les jetons de Clevera. Pour révoquer également l'accès de Clevera sur Bitbucket, ouvrez vos Paramètres personnels Bitbucket, allez dans Autorisations d'applications et révoquez Clevera.

Dépannage#

Sur le même sujet#