Publicar no Ghost

O Nolorem publica artigos de blogue diretamente no seu site Ghost utilizando a Ghost Admin API. Não é necessário qualquer plugin, porque o Ghost tem uma API nativa que trata da autenticação, da publicação e dos carregamentos de multimédia.

Ligar o Seu Site Ghost

1. Aceda às Definições e depois a Publicação.
2. Selecione o Ghost como a sua plataforma de CMS.
3. Introduza o URL do seu site Ghost (por exemplo https://yourblog.ghost.io). Não inclua uma barra final nem qualquer caminho como /ghost/.
4. Introduza a sua Admin API Key. Encontra-a no painel Ghost Admin em Settings, depois Integrations, depois Add custom integration. O formato da chave é {id}:{secret}.
5. Clique em Test connection para verificar.

Utilize a Admin API Key, não a Content API Key. A Content API Key é apenas de leitura e não pode publicar artigos.

Enviar um Artigo

1. Abra um artigo de blogue no editor.
2. Clique em Enviar para o CMS nas ações do artigo.
3. O Nolorem formata o conteúdo como um cartão Lexical HTML (o formato nativo do Ghost), carrega as imagens e cria o artigo através da Ghost Admin API.
4. Em caso de sucesso, aparece no editor uma ligação para o artigo Ghost publicado.

O Nolorem envolve o seu conteúdo no formato de cartão Lexical HTML do Ghost, para que os cabeçalhos, citações, imagens, ligações e estilos sejam todos apresentados corretamente sem problemas de conversão.

Atualizar um Artigo Existente

Se editar um artigo que já foi enviado, ao clicar em Enviar para o CMS atualiza o artigo Ghost existente. O Ghost utiliza controlo de concorrência otimista, por isso o Nolorem lê sempre o estado atual do artigo antes de atualizar.

Sincronização de Estado

O Ghost suporta três estados: rascunho, publicado e agendado.

• Definir o estado como Publicar cria ou atualiza o artigo como publicado.
• Definir uma data futura cria um artigo agendado.
• Despublicar no Nolorem repõe o artigo Ghost em rascunho.

Os webhooks do Ghost notificam o Nolorem quando os artigos mudam de estado do lado do Ghost. Os campos de SEO (meta título, meta descrição, OG título, OG descrição) são enviados diretamente como propriedades nativas do Ghost, por isso não é necessário qualquer plugin de SEO.

A Ligação Está a Falhar

Se o Test connection falhar:

• Verifique o URL do site. Utilize apenas o URL raiz, sem o caminho /ghost/ e sem barra final.
• Confirme que utilizou a Admin API Key, não a Content API Key apenas de leitura. A Admin key é o valor mais longo que contém um separador de dois-pontos ({id}:{secret}).
• Certifique-se de que executa o Ghost v5.0 ou posterior. As versões mais antigas podem utilizar diferentes endpoints de API.
• Se o Ghost estiver atrás de um proxy inverso ou de uma firewall, garanta que a Admin API em /ghost/api/admin/ está acessível através de HTTPS.

A Publicação Está a Falhar

Se um envio falhar, o editor mostra o erro devolvido pelo Ghost. Causas comuns:

• Site inacessível: verifique se o site está online e se o URL está correto. O Nolorem aplica um limite de tempo de 30 segundos às chamadas ao Ghost.
• Chave inválida ou eliminada: se removeu a integração personalizada no Ghost, crie uma nova e atualize a Admin API Key nas Definições, depois Publicação.
• Conflito de concorrência: se alguém editou o artigo diretamente no Ghost, volte a enviá-lo. O Nolorem lê o estado mais recente antes de cada atualização.
• Falha no carregamento de imagem: o Ghost impõe um limite de tamanho de ficheiro. Um erro HTTP 413 significa que uma imagem é demasiado grande. Utilize JPG, PNG, GIF ou WebP.
• Agendamento: a data agendada tem de estar no futuro, caso contrário o Ghost publica imediatamente.