Una plantilla inicial para crear sitios web ultrarrápidos con Ghost & Gatsby
Demostración: https://gatsby.ghost.org/
# 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
Luego instale las dependencias
yarn
Inicie el servidor de desarrollo. Ahora tienes un sitio de Gatsby que extrae contenido de Ghost sin cabeza.
gatsby develop
De forma predeterminada, el iniciador completará el contenido de una instalación predeterminada de Ghost ubicada en https://gatsby.ghost.io.
Para utilizar su propia instalación, deberá editar el archivo de configuración .ghost.json
con sus credenciales. Cambie el valor apiUrl
a la URL de su sitio Ghost. Para los clientes de Ghost (Pro), esta es la URL de Ghost que termina en .ghost.io
, y para las personas que usan la versión autohospedada de Ghost, es la misma URL utilizada para acceder a su sitio.
A continuación, actualice el valor contentApiKey
a una clave asociada con el sitio Ghost. Se puede proporcionar una clave creando una integración dentro de Ghost Admin. Navegue hasta Integraciones y haga clic en "Agregar nueva integración". Asigne un nombre apropiado a la integración y haga clic en crear.
Finalmente, configure la URL deseada en siteConfig.js
, para que los enlaces (por ejemplo, enlaces canónicos) se generen correctamente. También puede actualizar otros valores predeterminados, como postsPerPage
en este archivo.
Para utilizar este iniciador sin problemas, su instalación de Ghost debe tener al menos la versión 2.10.0
.
La versión predeterminada de Ghost que se utiliza para este iniciador es 5.x
Si su instalación de Ghost es una versión inferior, deberá pasar una propiedad version
en su configuración .ghost.json
:
Fantasma >=2.10.0 <5.0.0
{
"apiUrl" : " https://gatsby.ghost.io " ,
"contentApiKey" : " 9cc5c67c358edfdd81455149d0 " ,
"version" : " v4.0 "
}
Fantasma >=5.0.0
{
"apiUrl" : " https://gatsby.ghost.io " ,
"contentApiKey" : " 9cc5c67c358edfdd81455149d0 "
}
El iniciador contiene tres archivos de configuración específicamente para implementar con Netlify. Un archivo netlify.toml
para la configuración de compilación, un archivo /static/_headers
con encabezados de seguridad predeterminados configurados para todas las rutas y /static/_redirects
para configurar redirecciones de dominio personalizadas de Netlify.
Para implementar en su cuenta de Netlify, presione el botón a continuación.
Las claves API de contenido generalmente no se consideran información confidencial; existen para que puedan modificarse en caso de abuso; por lo que la mayoría de la gente lo envía directamente a su archivo de configuración .ghost.json
. Si prefiere mantener esta información fuera de su repositorio, puede eliminar esta configuración y configurar las variables ENV de Netlify para compilaciones de producción.
Una vez implementado, puede configurar una integración de Ghost + Netlify para usar enlaces de implementación de Ghost para activar reconstrucciones de Netlify. De esa manera, cada vez que los datos cambien en Ghost, su sitio se reconstruirá en Netlify.
Puede deshabilitar la interfaz predeterminada del tema Ghost manillares habilitando la marca Make this site private
dentro de la configuración de Ghost. Esto permite la protección con contraseña antes de la instalación de Ghost y configura <meta name="robots" content="noindex" />
para que su interfaz de Gatsby se convierta en la fuente de verdad para SEO.
# Run a production build, locally
gatsby build
# Serve a production build, locally
gatsby serve
Gatsby develop
usa la configuración development
en .ghost.json
, mientras que Gatsby build
usa la configuración production
.
Copyright (c) 2013-2025 Ghost Foundation: publicado bajo la licencia MIT.