Logo de Jamstatic
Jamstatic

Configurer Netlify CMS pour Jekyll

Nous partirons du principe que vous avez une installation de Jekyll déjà fonctionnelle, dans le cas contraire, reportez-vous à la documentation officielle. Nous présupposons également que vous versionnez votre projet avec Git et vous poussez votre code sur GitHub, GitLab ou BitBucket.

Configurer Netlify

La première étape est de se connecter chez Netlify afin de pouvoir relier votre dépôt Git à ce service d’hébergement et de déploiement continu. C’est gratuit et si vous travaillez sur un projet open source, vous pouvez utiliser la formule pro.

Ajout de site, étape 2 : choix du dépôt
Ajout de site, étape 2 : choix du dépôt.

L'ajout de site se fait en quelques clics, il n'y a qu'à sélectionner le service utilisé (GitHub pour nous), définir la branche (master dans notre cas) et la commande de build utilisée (jekyll build pour Jekyll) ainsi que le dossier de publication(_site par défaut avec Jekyll). Une fois le site configuré, nous allons pouvoir nous occuper d’autoriser l’édition de contenu via Netlify CMS.

Ajout de site, étape 3 : configuration du déploiement
Ajout de site, étape 3 : configuration du déploiement.

Authentification via GitHub

Maintenant il nous faut créer une nouvelle application Oauth sur GitHub (ou le service que vous utilisez) et de mentionner https://api.netlify.com/auth/done comme URL de callback d’authentification. Vous donnez ainsi l’autorisation à Netlify CMS d’accéder aux fichiers du dépôt.

Configuration de l’application Oauth dans GitHub
Configuration de l’application Oauth dans GitHub.

Ajout des fichiers de l’admin

Maintenant que l’authentification est configurée nous pouvons ajouter un dossier admin à la racine de notre dépôt qui contiendra deux fichiers : index.html et config.yml.