gatsby starter ghost

Gatsby Starter Fantôme

Un modèle de démarrage pour créer des sites Web ultra-rapides avec Ghost & Gatsby

Démo : https://gatsby.ghost.org/

Installation

 # With Gatsby CLI
gatsby new gatsby-starter-ghost https://github.com/TryGhost/gatsby-starter-ghost.git

 # From Source
git clone https://github.com/TryGhost/gatsby-starter-ghost.git
cd gatsby-starter-ghost

Puis installez les dépendances

yarn

En cours d'exécution

Démarrez le serveur de développement. Vous disposez maintenant d'un site Gatsby extrayant le contenu de Ghost sans tête.

gatsby develop

Par défaut, le démarreur remplira le contenu d'une installation Ghost par défaut située sur https://gatsby.ghost.io.

Pour utiliser votre propre installation, vous devrez modifier le fichier de configuration .ghost.json avec vos informations d'identification. Remplacez la valeur apiUrl par l'URL de votre site Ghost. Pour les clients Ghost(Pro), il s'agit de l'URL Ghost se terminant par .ghost.io , et pour les personnes utilisant la version auto-hébergée de Ghost, il s'agit de la même URL que celle utilisée pour accéder à votre site.

Ensuite, mettez à jour la valeur contentApiKey avec une clé associée au site Ghost. Une clé peut être fournie en créant une intégration dans Ghost Admin. Accédez à Intégrations et cliquez sur « Ajouter une nouvelle intégration ». Nommez l’intégration de manière appropriée et cliquez sur Créer.

Enfin, configurez l'URL souhaitée dans siteConfig.js , afin que les liens (par exemple les liens canoniques) soient générés correctement. Vous pouvez également mettre à jour d'autres valeurs par défaut, telles que postsPerPage dans ce fichier.

Pour utiliser ce démarreur sans problème, votre installation Ghost doit être au moins sur la version 2.10.0 .

La version Ghost par défaut utilisée pour ce démarreur est 5.x . Si votre installation Ghost est sur une version inférieure, vous devrez transmettre une propriété version dans vos paramètres .ghost.json :

Fantôme >=2.10.0 <5.0.0

{
    "apiUrl" : " https://gatsby.ghost.io " ,
    "contentApiKey" : " 9cc5c67c358edfdd81455149d0 " ,
    "version" : " v4.0 "
}

Fantôme >=5.0.0

{
    "apiUrl" : " https://gatsby.ghost.io " ,
    "contentApiKey" : " 9cc5c67c358edfdd81455149d0 "
}

Déployer avec Netlify

Le démarreur contient trois fichiers de configuration spécifiquement pour le déploiement avec Netlify. Un fichier netlify.toml pour les paramètres de construction, un fichier /static/_headers avec des en-têtes de sécurité par défaut définis pour toutes les routes et /static/_redirects pour définir les redirections de domaine personnalisées Netlify.

Pour déployer sur votre compte Netlify, cliquez sur le bouton ci-dessous.

Les clés API de contenu ne sont généralement pas considérées comme des informations sensibles, elles existent pour pouvoir être modifiées en cas d'abus ; donc la plupart des gens le valident directement dans leur fichier de configuration .ghost.json . Si vous préférez conserver ces informations en dehors de votre référentiel, vous pouvez supprimer cette configuration et définir à la place les variables Netlify ENV pour les versions de production.

Une fois déployé, vous pouvez configurer une intégration Ghost + Netlify pour utiliser les hooks de déploiement de Ghost pour déclencher les reconstructions Netlify. De cette façon, chaque fois que les données changent dans Ghost, votre site sera reconstruit sur Netlify.

Optimisation

Vous pouvez désactiver le thème frontal Ghost Handles par défaut en activant l'indicateur Make this site private dans vos paramètres Ghost. Cela active la protection par mot de passe avant l'installation de Ghost et définit <meta name="robots" content="noindex" /> afin que votre interface Gatsby devienne la source de vérité pour le référencement.

Options supplémentaires

 # Run a production build, locally
gatsby build

# Serve a production build, locally
gatsby serve

Gatsby develop utilise la configuration development dans .ghost.json - tandis que Gatsby build utilise la configuration production .

Droit d'auteur et licence

Copyright (c) 2013-2025 Ghost Foundation - Publié sous licence MIT.