jekyll netlify boilerplate

Jekyll Netlify passe-partout

Remarque : consultez mon Eleventy Netlify Boilerplate. Il fait à peu près la même chose que ce projet mais utilise le générateur de site statique Eleventy. C'est rapide, flexible et ne nécessite pas Ruby.

Un modèle Jekyll très simple pour créer un site Web rapide et statique sur Netlify avec un flux de travail de déploiement continu.

Ce projet est présenté sur la vitrine de modèles et le blog officiels de Netlify : Les 10 meilleurs générateurs de sites statiques à surveiller en 2018

• Style minimal, prêt à créer le vôtre
• Exemples d'articles de blog, de pages et de formulaire de contact
• Disposition de grille CSS réactive avec solutions de secours pour les anciens navigateurs
• Workflow de déploiement continu via Netlify et Github
• Netlify CMS pour gérer le contenu
• Netlify Identity pour authentifier les utilisateurs
• Netlify Forms pour traiter vos formulaires HTML statiques avec reCAPTCHA
• Fichiers Netlify _redirects et _headers facultatifs prêts à l'emploi
• Pipeline Jekyll SASS
• HTML et CSS minifiés

Basé sur le modèle de démarrage Jekyll + Netlify CMS de Netlify, rendez-vous là-bas pour plus de détails sur les paramètres de déploiement et de construction ou pour obtenir de l'aide sur la configuration de Netlify.

Pour obtenir de l'aide sur les modèles, le développement local et d'autres éléments liés à Jekyll, consultez l'excellent Jekyll Docs.

Voir la démo

Performance

Vous pouvez tester le TTFB (Time To First Byte) du site de démonstration sur testmysite.io

Commencer

Cliquez simplement sur le bouton Déployer pour obtenir votre propre copie du référentiel déployée sur Netlify :

Cela configurera tout le nécessaire pour exécuter le CMS :

• Un nouveau dépôt dans votre compte GitHub avec le code
• Déploiement continu complet sur le réseau CDN mondial de Netlify
• Contrôlez les utilisateurs et les accès avec Netlify Identity
• Gérer le contenu avec Netlify CMS

Configurer l'authentification

Après avoir déployé ce projet, Netlify Identity vous ajoutera en tant qu'utilisateur CMS et vous enverra une invitation par e-mail. Il n'est pas nécessaire d'accepter cette invitation si vous souhaitez utiliser un fournisseur OAuth (par exemple Github) pour gérer l'authentification de votre CMS. Il est recommandé d'utiliser cette méthode d'authentification car elle supprime le besoin d'un e-mail et d'un mot de passe pour se connecter au CMS et est généralement plus sécurisée. Vous devrez ajouter un fournisseur OAuth dans les paramètres de votre application Netlify sous « Paramètres » > « Identité » > « Fournisseurs externes ».

Ensuite, accédez à /admin sur votre site, choisissez votre fournisseur OAuth dans la zone de connexion et vous devriez alors être connecté à votre CMS.

Vous êtes maintenant prêt et vous pouvez commencer à éditer du contenu !

Remarque : si vous passez le dépôt créé à privé, vous devrez régénérer votre jeton, car le jeton généré à l'aide du bouton Déployer sur Netlify ne peut accéder qu'aux référentiels publics. Pour régénérer votre token, rendez-vous dans « Paramètres » dans le tableau de bord de votre site Netlify, accédez à la section « Identité », puis faites défiler jusqu'à « Services » où vous verrez un bouton « Modifier les paramètres ». Cliquez dessus et vous verrez un lien texte vers "Générer un jeton d'accès dans GitHub".

Développement local

Clonez ce référentiel et exécutez :

bundle install
bundle exec jekyll server --watch

Si vous ne souhaitez pas installer Ruby-bundler, vous pouvez utiliser Docker :

docker-compose up

Jekyll surveillera votre dossier de projet pour les modifications.

Accédez maintenant à localhost:4000 pour prévisualiser le site et à localhost:4000/admin pour vous connecter au CMS.

Rapports de bogues, demandes de fonctionnalités, etc.

Il s'agit d'un projet en cours et j'apprécie les contributions. N'hésitez pas à soumettre un PR.

Si vous avez besoin d'aide pour configurer Netlify CMS, vous pouvez contacter l'équipe Netlify dans Netlify CMS Gitter.