Connecter GitHub ou GitLab (pull requests)

Pour quels sites

Un site dont les pages sont produites depuis un dépôt GitHub ou GitLab : Next.js, Astro, Nuxt, Hugo, Jekyll ou HTML statique. NeoRank relie chaque page à son fichier source ; une page servie par un segment dynamique (par exemple un article de blog généré depuis une collection) devient un point à vérifier plutôt qu'une modification.

Connecter GitHub

1. Dans NeoRank, Paramètres › Connecteurs, carte « GitHub / GitLab — pull requests » : « Installer l'app GitHub NeoRank ».
2. Chez GitHub, installez l'app sur le seul dépôt à partir duquel ce site est construit (« Only select repositories »), puis enregistrez. Il vous faut un accès en écriture (push) ou administrateur à ce dépôt.
3. De retour dans NeoRank, confirmez le dépôt : « Utiliser ce dépôt ».
4. Approuvez des corrections : chaque lot ouvre une pull request que vous relisez et fusionnez.

Connecter GitLab

1. Dans votre projet GitLab › Settings › Access tokens : créez un Project Access Token, rôle Developer, scope api, expiration d'un an au plus.
2. Dans NeoRank, « Utiliser GitLab à la place » : collez l'ID ou le chemin du projet (groupe/projet) et le jeton ; NeoRank le vérifie et le stocke chiffré.
3. Ajoutez le webhook de projet que NeoRank affiche une seule fois (URL et jeton secret) dans GitLab › Settings › Webhooks, avec « Merge request events » et « Deployment events ».

Ce que contient la pull request

• Une branche neorank/… et une pull request intitulée « NeoRank: N SEO fixes for votre-domaine ».
• Pour chaque changement : le type (titre, meta description…), le constat d'audit, la page, le fichier, l'avant et l'après. Le texte rappelle que chaque changement a été approuvé dans NeoRank et que la fusion est votre décision.
• Le diff ne touche que les lignes concernées. Une modification que NeoRank ne peut pas faire sans risque devient un point à vérifier dans la pull request (rien n'est écrit pour elle).

Les couleurs sur Git

• Proposée · à validerRien n'est encore dans votre dépôt.
• Pull request ouverte · à fusionnerLe lot est dans une pull request ouverte. Pas encore en ligne : la correction sera en ligne quand vous l'aurez fusionnée et déployée.
• Corrigée et vérifiéeFusionnée, déployée, et NeoRank a relu la page en ligne.
• Pull request fermée sans fusionLa correction redevient « proposée » : vous pouvez la modifier et l'approuver de nouveau.

Nom ajouté aux titres

Si votre gabarit ajoute le nom du site à chaque titre (« Tarifs | Acme »), indiquez ce nom dans Gérer › Nom ajouté aux titres. Sans lui, NeoRank ne peut pas prouver que le fichier produit bien le titre relevé, et répond « Votre gabarit ajoute le nom du site aux titres : confirmez ce nom sur la carte GitHub / GitLab ». Laissez vide si les titres sont écrits en entier.

Pause et révocation

• Mettre en pause : aucune nouvelle pull request avant la reprise.
• Révoquer déconnecte le dépôt : aucune nouvelle pull request n'est ouverte. Les pull requests ouvertes restent dans votre dépôt ; désinstallez aussi l'app GitHub, ou supprimez le jeton GitLab, de leur côté.

Problèmes fréquents