Guide d'intégration GitHub

1. Créer un token GitHub

Sur GitHub : Settings → Developer settings → Personal access tokens → Fine-grained tokens. Limitez son accès à ce seul dépôt (« Only select repositories ») et donnez-lui la permission Contents : Read and write — aucune autre permission n'est nécessaire.

2. Connecter le dépôt

Depuis la page Intégrations, dans le bloc « GitHub », renseignez le propriétaire (utilisateur ou organisation) et le nom du dépôt, la branche (laissez vide pour utiliser la branche par défaut du dépôt), le dossier de contenu (par défaut content) et collez le token créé à l'étape précédente. L'accès est vérifié immédiatement contre l'API GitHub avant d'être enregistré (token chiffré, jamais stocké en clair). Seuls les propriétaires/administrateurs de l'organisation peuvent connecter ou déconnecter un dépôt.

3. Publier ou programmer

Depuis Copywriting, chaque contenu généré (Article de Blog, Fiche Produit, Local Page, Service Page) dispose d'un bouton Publier sur GitHub, avec un champ Programmer (optionnel) : laissez-le vide pour committer immédiatement, ou choisissez une date/heure future — la publication programmée est traitée automatiquement au moment prévu (vérifié toutes les 5 minutes), annulable tant qu'elle n'est pas encore partie.

4. Où atterrit le fichier

Chaque publication crée (ou met à jour si le fichier existe déjà) un fichier Markdown à {dossier de contenu}/{type}/{slug}.md, où {type} vaut articles, fiches-produit, pages-locales, pages-service ou accueil selon l'outil utilisé. Exemple pour un article publié dans le dossier par défaut :

content/articles/mon-article.md

Contenu du fichier :

---
title: "Titre de l'article"
description: "Méta-description de l'article"
slug: "mon-article"
date: "2026-07-18T10:00:00.000Z"
---
<h1>...</h1>
<p>...</p>

Le contenu est embarqué en HTML brut (pas de conversion Markdown) : la quasi-totalité des générateurs de site statique (Jekyll, Hugo, Astro, Next.js/MDX) acceptent du HTML brut dans le corps d'un fichier Markdown, ce qui évite toute perte de mise en forme.

5. Exemple de lecture côté site (Next.js)

Si votre site lit ces fichiers directement depuis le dépôt (au build, via le système de fichiers) :

import fs from "node:fs";
import path from "node:path";
import matter from "gray-matter";

function getArticles() {
  const dir = path.join(process.cwd(), "content/articles");
  return fs.readdirSync(dir).map((file) => {
    const { data, content } = matter.read(path.join(dir, file));
    return { ...data, html: content };
  });
}

Chaque commit sur la branche connectée déclenche normalement un nouveau déploiement sur Vercel/Netlify (via leur intégration Git native) — aucune configuration supplémentaire n'est nécessaire côté iziRanker pour republier votre site.

6. Sécurité

• Le token n'est jamais affiché en clair après son enregistrement — en cas de doute, déconnectez le dépôt et reconnectez-le avec un nouveau token.
• Limitez toujours le token à ce seul dépôt et à la permission Contents : ne créez jamais un token avec un accès plus large que nécessaire.