Decap CMS & Astro
Decap CMS (anciennement Netlify CMS) est un système de gestion de contenu open-source basé sur Git.
Decap vous permet de profiter pleinement de toutes les fonctionnalités d’Astro, y compris l’optimisation des images et les collections de contenu.
Decap ajoute une route (typiquement /admin
) à votre projet qui chargera une application React pour permettre aux utilisateurs autorisés de gérer le contenu directement depuis le site web déployé. Decap commettra les changements directement dans le référentiel source de votre projet Astro.
Installation de DecapCMS
Titre de la section Installation de DecapCMSIl existe deux options pour ajouter Decap à Astro :
-
Installer Decap via un gestionnaire de paquets avec la commande suivante :
-
Importez le paquet dans une balise
<script>
de votre page<body>
Configuration
Titre de la section Configuration-
Créez un dossier d’administration statique dans
public/admin/
-
Ajoutez
config.yml
àpublic/admin/
:Répertoirepublic
Répertoireadmin
- config.yml
-
Pour ajouter le support des collections de contenu, configurez chaque schéma dans
config.yml
. L’exemple suivant configure une collectionblog
, en définissant unlabel
pour la propriété frontmatter de chaque entrée : -
Ajoutez la route
admin
pour votre application React. Ce fichier peut-être soitpublic/admin/index.html
à côté de votreconfig.yml
ou, si vous préférez utiliser une route Astro,src/pages/admin.astro
.
Répertoirepublic
Répertoireadmin
- config.yml
- index.html
- Pour permettre le téléchargement de médias dans un dossier spécifique via l’éditeur Decap, ajoutez un chemin d’accès approprié :
Voir la documentation de configuration du CMS Decap pour des instructions et des options complètes.
Utilisation
Titre de la section UtilisationNaviguez vers votre site.com/admin/
pour utiliser l’éditeur de Decap CMS.
Authentification
Titre de la section AuthentificationDecap CMS avec Netlify Identity
Titre de la section Decap CMS avec Netlify IdentityDecap CMS a été développé à l’origine par Netlify et dispose d’un support pour Netlify Identity.
Lors du déploiement sur Netlify, configurez l’identité pour votre projet via le tableau de bord Netlify et incluez le Netlify Identity Widget sur la route admin
de votre projet. Vous pouvez également inclure le widget d’identité sur la page d’accueil de votre site si vous prévoyez d’inviter de nouveaux utilisateurs par e-mail.
Decap CMS avec des clients OAuth externes
Titre de la section Decap CMS avec des clients OAuth externesLorsque vous déployez vers des hébergeurs autres que Netlify, vous devez créer vos propres routes OAuth.
Dans Astro, cela peut être fait avec des routes rendues à la demande dans votre projet configuré avec la sortie server
ou hybrid
activé.
Voir Decap’s OAuth Docs pour une liste de clients OAuth compatibles maintenus par la communauté.
Ressources communautaires
Titre de la section Ressources communautaires-
Utilisez l’intégration Astro
astro-netlify-cms
pour ajouter Netlify CMS à votre projet. -
Vous pouvez commencer avec le kit Astro Blog Starter with Netlify CMS.
-
Article de blog : Créez le contenu de votre site Astro avec des CMS basés sur Git par Aftab Alam
-
Tutoriel Youtube : Créez un blog personnalisé avec Astro et NetlifyCMS en quelques minutes par Kumail Pirzada
Sites de production
Titre de la section Sites de productionLes sites suivants utilisent Astro + Decap CMS en production :
- yunielacosta.com par Yuniel Acosta - code source sur GitHub (Netlify CMS)
- portfolioris.nl par Joris Hulsbosch - code source sur GitHub