gatsby starter ghost

Fantasma inicial de Gatsby

Um modelo inicial para construir sites extremamente rápidos com Ghost e Gatsby

Demonstração: https://gatsby.ghost.org/

Instalando

 # 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

Em seguida, instale as dependências

yarn

Correndo

Inicie o servidor de desenvolvimento. Agora você tem um site Gatsby extraindo conteúdo do Ghost sem cabeça.

gatsby develop

Por padrão, o starter preencherá o conteúdo de uma instalação padrão do Ghost localizada em https://gatsby.ghost.io.

Para usar sua própria instalação, você precisará editar o arquivo de configuração .ghost.json com suas credenciais. Altere o valor apiUrl para o URL do seu site Ghost. Para clientes do Ghost (Pro), este é o URL do Ghost que termina em .ghost.io e, para pessoas que usam a versão auto-hospedada do Ghost, é o mesmo URL usado para acessar seu site.

Em seguida, atualize o valor contentApiKey para uma chave associada ao site Ghost. Uma chave pode ser fornecida criando uma integração no Ghost Admin. Navegue até Integrações e clique em “Adicionar nova integração”. Nomeie a integração apropriadamente e clique em criar.

Por fim, configure a URL desejada em siteConfig.js , para que os links (por exemplo, links canônicos) sejam gerados corretamente. Você também pode atualizar outros valores padrão, como postsPerPage neste arquivo.

Para usar este starter sem problemas, a instalação do Ghost precisa estar pelo menos na versão 2.10.0 .

A versão padrão do Ghost usada para este iniciador é 5.x . Se a instalação do Ghost estiver em uma versão inferior, você precisará passar uma propriedade version nas configurações .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 "
}

Implantando com Netlify

O starter contém três arquivos de configuração especificamente para implantação com Netlify. Um arquivo netlify.toml para configurações de compilação, um arquivo /static/_headers com cabeçalhos de segurança padrão definidos para todas as rotas e /static/_redirects para definir redirecionamentos de domínio personalizados do Netlify.

Para implantar em sua conta Netlify, clique no botão abaixo.

As chaves da API de conteúdo geralmente não são consideradas informações confidenciais; elas existem para que possam ser alteradas em caso de abuso; então a maioria das pessoas o envia diretamente para o arquivo de configuração .ghost.json . Se preferir manter essas informações fora do seu repositório, você pode remover esta configuração e definir variáveis ​​Netlify ENV para compilações de produção.

Depois de implantado, você pode configurar uma integração Ghost + Netlify para usar ganchos de implantação do Ghost para acionar reconstruções do Netlify. Dessa forma, sempre que os dados forem alterados no Ghost, seu site será reconstruído no Netlify.

Otimizando

Você pode desativar o front-end padrão do Ghost Handlebars Theme ativando o sinalizador Make this site private nas configurações do Ghost. Isso permite a proteção por senha antes da instalação do Ghost e define <meta name="robots" content="noindex" /> para que seu front-end Gatsby se torne a fonte da verdade para SEO.

Opções extras

 # Run a production build, locally
gatsby build

# Serve a production build, locally
gatsby serve

develop de Gatsby usa a configuração development em .ghost.json - enquanto build de Gatsby usa a configuração production .

Direitos autorais e licença

Copyright (c) 2013-2025 Ghost Foundation - Lançado sob a licença do MIT.