Um iniciador Gatsby para criar blogs a partir do Ghost CMS sem cabeça.
Transforme seu blog Ghost em um site estático e rápido. Este tema Gatsby é uma substituição frontal do motor Ghost Handlebars com uma aparência aprimorada do Ghost Casper. Todo o conteúdo é proveniente de um Ghost CMS sem cabeça.
Cansado de
gatsby-config.js
? Confira o Blogody para uma solução integrada com muito mais benefícios!
Favorece Next.js em vez de Gatsby? Vá para next-cms-ghost!
Confira os Tutoriais para guias práticos sobre como usar este projeto.
Brinque com a Demo para ter uma primeira impressão.
Os seguintes plug-ins foram incluídos por conveniência:
Nome | Versão | Descrição |
---|---|---|
gatsby-theme-ghost-dark-mode | Alternar modo escuro? | |
gatsby-rehype-ghost-links | Reescrever links CMS de absoluto para relativo | |
gatsby-rehype-prismjs | Destaque de sintaxe com PrismJS | |
gatsby-theme-ghost-members ? | Assinaturas de membros |
Se não precisar deles, você pode retirá-los em gatsby-config.js
e package.json
o que pode economizar algum tempo durante o processo de construção.
Recursos adicionais podem ser integrados instalando temas ou plug-ins Gatsby. Os seguintes plug-ins foram testados para funcionar com gatsby-starter-try-ghost
:
Nome | Versão | Descrição |
---|---|---|
gatsby-rehype-inline-images ? | Imagens embutidas de carregamento lento com desfoque | |
gatsby-theme-ghost-contact | Página de contato | |
gatsby-theme-ghost-commento | Sistema de comentários com Commento | |
gatsby-theme-ghost-toc ? | Índice | |
gatsby-plugin-ackee-tracker | Rastreamento de site com Ackee | |
gatsby-plugin-google-analytics | Acompanhamento de sites com Google Analytics |
Instale este starter executando
gatsby new try-ghost https://github.com/styxlab/gatsby-starter-try-ghost
Alterar diretório
cd try-ghost
Correr
yarn develop
e visite seu site em http://localhost:8000
.
//siteConfig.js
module . exports = {
// Do not include a trailing slash!
siteUrl : `https://your-blog.com` ,
// Maximum number of post shown per page
// Infinite Scroll: Initial chunk of posts, subsequent posts are fetched one by one
postsPerPage : 3 ,
// This allows an alternative site title for meta data for pages.
siteTitleMeta : `Gatsby Starter Ghost CMS` ,
// This allows an site description for meta data for pages.
siteDescriptionMeta : `Turn your Ghost blog into a flaring fast static site with Gatsby` ,
// Used for App and Offline manifest e.g. Mobile Home Screen
shortTitle : `Ghost` ,
siteIcon : `favicon.png` ,
backgroundColor : `#e9e9e9` ,
themeColor : `#15171A` ,
// Include Gatsby images for lazy loading and image optimizations (default: true)
gatsbyImages : true ,
// Overwrite navigation menu (default: []), label is case sensitive
// overwriteGhostNavigation: [{ label: `Home`, url: `/` }],
} ;
Na configuração mostrada acima, os campos mais importantes a serem alterados são siteUrl
, siteTitleMeta
e siteDescriptionMeta
. Atualize pelo menos aqueles para atender às suas necessidades.
Todo o conteúdo é proveniente de um Ghost CMS. Por padrão, o conteúdo é obtido no local de demonstração em https://cms.gotsby.org
. Certamente você deseja obter seu próprio conteúdo. Existem duas maneiras de disponibilizar suas chaves de conteúdo. Escolha o método de acordo com seu cenário de construção.
Se você construir seu projeto com um provedor de nuvem (por exemplo, Gatsby, Netlify, Vercel), a melhor opção é fornecer as chaves com variáveis de ambiente:
Chave | Valor (exemplo) |
---|---|
GHOST_API_URL | http://localhost:2368 |
GHOST_CONTENT_API_KEY | 9fccdb0e4ea5b572e2e5b92942 |
O local onde você pode defini-los depende do provedor, mas normalmente você encontra a opção nas configurações do site. Isso evita a publicação de chaves em um repositório público e é mais seguro.
Se você construir localmente ou em uma rede privada onde o diretório de construção não está acessível ao mundo, você pode adicionar com segurança um novo arquivo .ghost.json
em seu diretório base com a seguinte estrutura JSON:
{
" development " : {
" apiUrl " : " http://localhost:2368 " ,
" contentApiKey " : " 9fccdb0e4ea5b572e2e5b92942 "
},
" production " : {
" apiUrl " : " http://localhost:2368 " ,
" contentApiKey " : " 9fccdb0e4ea5b572e2e5b92942 "
}
}
Este arquivo faz parte do .gitignore
para evitar publicá-lo acidentalmente em seu repositório público. Altere apiUrl
e contentApiKey
para corresponder às suas próprias chaves da API de conteúdo do Ghost CMS.
Para obter melhores resultados de SEO, é altamente recomendável desativar o front-end padrão do tema Ghost Handlebars selecionando o sinalizador Tornar este site privado nas configurações de administrador 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 autorizada para mecanismos de pesquisa.
É recomendado instalar o npm-upgrade com sudo npm install npm-upgrade -g
. Mude para o diretório base e atualize todos os pacotes com:
npm-upgrade
Você será solicitado a atualizar todos os pacotes em seu arquivo package.json
. A seguir, baixe os novos pacotes:
yarn
yarn clean
O processo de atualização agora está completo e você pode iniciar uma nova construção com yarn build
(ou yarn develop
).
Por favor, relate todos os bugs e problemas em gatsby-theme-try-ghost/issues, pois todo o desenvolvimento está acontecendo lá.
Este projeto não é afiliado a Gatsby ou Ghost.
Copyright (c) 2020 styxlab – Lançado sob a licença do MIT.