gatsby starter ghost

Fantasma inicial de Gatsby

Una plantilla inicial para crear sitios web ultrarrápidos con Ghost & Gatsby

Demostración: https://gatsby.ghost.org/

Instalación

 # 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

Correr

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 "
}

Implementación con Netlify

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.

Optimización

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.

Opciones adicionales

 # 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 .

Derechos de autor y licencia

Copyright (c) 2013-2025 Ghost Foundation: publicado bajo la licencia MIT.