Publier des articles sur GitHub

Connectez GitHub une fois pour toutes et vous pourrez publier n'importe quel article Clevera dans un dépôt sous forme de fichier Markdown, prêt pour un site de documentation, un dossier de type wiki docs/ ou une collection de fichiers README. 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 GitHub 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 GitHub. Une fois connecté, toute personne pouvant modifier un article peut le publier.
• Accès dans GitHub : la personne qui effectue la connexion doit disposer d'un accès en écriture aux dépôts vers lesquels vous souhaitez publier, et du droit d'installer une application GitHub sur ce compte personnel ou cette organisation (ou obtenir l'approbation d'un propriétaire d'organisation).
• Un article : vous publiez l'article associé à 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 GitHub#

1. Ouvrir les Intégrations#

   Dans la barre latérale, ouvrez le menu de l'espace de travail et choisissez Intégrations. Trouvez GitHub sous Intégrations disponibles (ou l'onglet Développement) et cliquez sur Connecter. Le bouton apparaît lorsque vous pointez sur la carte.

   

2. Autoriser Clevera sur GitHub#

   GitHub vous demande d'autoriser l'application Clevera AI. Elle demande un accès en lecture à vos appartenances à des organisations, afin que Clevera puisse lister les comptes auxquels vous appartenez. Cliquez sur Autoriser.

3. Installer l'application sur vos dépôts#

   GitHub ouvre ensuite la page d'installation de l'application Clevera AI. Choisissez votre compte personnel ou une organisation, puis sélectionnez Tous les dépôts ou Sélectionner uniquement des dépôts. L'application demande :

   Autorisation GitHub	Pourquoi
   Contenu : lecture et écriture	Pour créer et mettre à jour le fichier Markdown et ses images
   Métadonnées : lecture seule	Requis par GitHub pour chaque application ; permet à Clevera de lister les dépôts

   Cliquez sur Installer. Répétez l'opération pour chaque organisation vers laquelle vous souhaitez publier.

4. Vérifier la connexion#

   De retour sur Intégrations, GitHub se déplace dans la liste Connecté avec le nom de votre compte ou organisation GitHub et un badge Connecté. Avant de publier quoi que ce soit, il est indiqué "Rien n'a encore été publié".

   

Ajouter ou supprimer des dépôts plus tard#

Clevera ne voit que les dépôts sur lesquels l'application est installée. Pour modifier cela, ouvrez Intégrations, cliquez sur GitHub, et sous Accès, cliquez sur Accès au dépôt. Sur GitHub, ouvrez le compte, cliquez sur Configurer et modifiez la liste des dépôts. Les nouveaux dépôts apparaîtront la prochaine fois que vous ouvrirez l'onglet Publier.

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 GitHub 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 compte, le dépôt et le dossier#

   Sous Où cela va-t-il, choisissez :

   Champ	Que choisir	Notes
   Compte	Votre compte personnel ou une organisation	Affiché uniquement lorsque vos dépôts appartiennent à plusieurs comptes
   Dépôt	Le dépôt pour le fichier	Les plus récemment mis à jour en premier. Le premier est sélectionné pour vous
   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 vos choix pour la prochaine fois.

   

3. Publier#

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

   Vous pouvez fermer la fenêtre Partager pendant l'opération ; une notification vous informe lorsqu'elle est terminée.

Où va le fichier#

• Branche : la branche par défaut du dépôt (généralement main). Clevera effectue le commit directement dessus ; elle n'ouvre pas de pull request et vous ne pouvez pas choisir une autre branche.
• Nom de fichier : le titre en minuscules, avec les espaces remplacés par des traits d'union, 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 restant à transcrire, comme un titre composé uniquement d'émojis, reçoit un code fixe court à la place (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>/ à l'intérieur du même dossier, dans le même commit.
• Message de commit : Add article: <title>, ou Update article: <title> lorsque vous mettez à jour un fichier existant.
• Auteur du commit : le compte GitHub qui a connecté l'intégration.

À quoi ressemble le fichier#

Clevera écrit du Markdown compatible GitHub avec un court bloc de front matter en haut :

---
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 commitées dans votre dépôt à côté du fichier, et le Markdown y fait référence 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 dépôt.

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

Utiliser avec un site de documentation#

La plupart des générateurs de sites statiques qui construisent à partir d'un dépôt (comme Docusaurus, MkDocs, Jekyll ou Hugo) lisent title depuis le front matter et ignorent les champs qu'ils ne connaissent pas. Une configuration courante :

1. Pointez le Dossier vers le dossier que votre site de documentation lit, par exemple docs ou content/guides.
2. Publiez chaque article à cet endroit ; la construction normale de votre site récupère le nouveau commit.
3. Vérifiez si votre générateur affiche les alertes GitHub, les mathématiques et <details> ; certains affichent les alertes sous forme de citations simples.

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

La publication ne se fait 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 sur GitHub ne reviennent jamais dans Clevera.

Lorsque vous publiez dans 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à sur GitHub". Cliquez sur Le voir pour ouvrir le fichier existant, puis choisissez :

Si le titre est modifié dans Clevera, le nom du fichier change également ; la publication crée donc un nouveau fichier à côté de l'ancien. Supprimez ou renommez vous-même l'ancien fichier sur GitHub.

Rien dans Clevera ne supprime des fichiers de votre dépôt.

Déconnecter GitHub#

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

La déconnexion supprime le jeton d'accès de Clevera. Pour supprimer également l'accès de Clevera sur GitHub, désinstallez l'application Clevera AI (Paramètres GitHub → Applications → Installed GitHub Apps → Configure → Uninstall) et révoquez l'autorisation sous Authorized GitHub Apps.

Dépannage#

Sur le même sujet#