Publicar en Ghost

Nolorem publica entradas de blog directamente en tu sitio de Ghost usando la Admin API de Ghost. No se necesita ningún plugin, porque Ghost tiene una API nativa que gestiona la autenticación, la publicación y la carga de medios.

Conecta tu sitio de Ghost

1. Ve a Ajustes, luego Publicación.
2. Selecciona Ghost como plataforma CMS.
3. Introduce la URL de tu sitio de Ghost (por ejemplo https://yourblog.ghost.io). No incluyas una barra final ni ninguna ruta como /ghost/.
4. Introduce tu Admin API Key. La encuentras en el panel de Ghost Admin en Settings, luego Integrations, luego Add custom integration. El formato de la clave es {id}:{secret}.
5. Haz clic en Probar conexión para verificar.

Usa la Admin API Key, no la Content API Key. La Content API Key es de solo lectura y no puede publicar entradas.

Enviar una entrada

1. Abre una entrada de blog en el editor.
2. Haz clic en Push to CMS en las acciones de la entrada.
3. Nolorem da formato al contenido como una tarjeta Lexical HTML (el formato nativo de Ghost), sube las imágenes y crea la entrada mediante la Admin API de Ghost.
4. Si tiene éxito, aparece en el editor un enlace a la entrada publicada en Ghost.

Nolorem envuelve tu contenido en el formato de tarjeta Lexical HTML de Ghost, de modo que los encabezados, las citas, las imágenes, los enlaces y los estilos se muestran correctamente sin problemas de conversión.

Actualizar una entrada existente

Si editas una entrada que ya se había enviado, al hacer clic en Push to CMS se actualiza la entrada existente en Ghost. Ghost utiliza control de concurrencia optimista, por lo que Nolorem siempre lee el estado actual de la entrada antes de actualizarla.

Sincronización de estado

Ghost admite tres estados: borrador, publicada y programada.

• Establecer el estado en Publicar crea o actualiza la entrada como publicada.
• Establecer una fecha futura crea una entrada programada.
• Despublicar en Nolorem devuelve la entrada de Ghost al estado de borrador.

Los webhooks de Ghost notifican a Nolorem cuando las entradas cambian de estado en el lado de Ghost. Los campos SEO (meta título, meta descripción, título OG, descripción OG) se envían directamente como propiedades nativas de Ghost, por lo que no se necesita ningún plugin de SEO.

La conexión falla

Si Probar conexión falla:

• Comprueba la URL del sitio. Usa solo la URL raíz, sin la ruta /ghost/ y sin barra final.
• Confirma que usaste la Admin API Key, no la Content API Key de solo lectura. La clave Admin es el valor más largo que contiene un separador de dos puntos ({id}:{secret}).
• Asegúrate de ejecutar Ghost v5.0 o posterior. Las versiones anteriores pueden usar endpoints de API diferentes.
• Si Ghost está detrás de un proxy inverso o un firewall, asegúrate de que la Admin API en /ghost/api/admin/ sea accesible por HTTPS.

La publicación falla

Si un envío falla, el editor muestra el error devuelto por Ghost. Causas comunes:

• Sitio inaccesible: verifica que el sitio esté en línea y que la URL sea correcta. Nolorem aplica un tiempo de espera de 30 segundos a las llamadas de Ghost.
• Clave inválida o eliminada: si eliminaste la integración personalizada en Ghost, crea una nueva y actualiza la Admin API Key en Ajustes, luego Publicación.
• Conflicto de concurrencia: si alguien editó la entrada directamente en Ghost, vuelve a enviarla. Nolorem lee el estado más reciente antes de cada actualización.
• Fallo en la carga de imágenes: Ghost impone un límite de tamaño de archivo. Un error HTTP 413 significa que una imagen es demasiado grande. Usa JPG, PNG, GIF o WebP.
• Programación: la fecha programada debe estar en el futuro, de lo contrario Ghost publica de inmediato.