Publier sur votre propre site

Nolorem publie sur WordPress, Ghost et Webflow via leurs propres API. Si votre site n'est aucun des trois, il n'a pas besoin de l'être. Déclarez-le comme votre propre site, et Nolorem devient une destination de publication à part entière, au même titre que n'importe quel connecteur.

Cet article parcourt l'installation du premier jour, du début à la fin. Il ne présuppose rien de la technologie de votre site, si ce n'est qu'il peut recevoir une requête HTTP.

Ce que cet arrangement recouvre réellement

Lisez ceci en premier, car cela détermine comment vous construisez l'autre côté.

Nolorem n'appelle jamais votre site. Il n'y a ni webhook, ni push, ni rappel. C'est votre site qui appelle Nolorem, selon le rythme que vous choisissez. L'API de contenu public est un flux en lecture seule : votre site l'interroge, et tout le reste, y compris la fréquence, vous appartient.

Nolorem vous prévient quand votre propre configuration semble incorrecte. Si votre site est déclaré mais que rien ne va le chercher, ou que quelque chose va le chercher sans rien recevoir en retour, cela apparaît sur la page des paramètres de publication plutôt que de rester invisible. La section plus bas sur la vérification que votre site interroge bien le flux n'est pas un détail secondaire ; elle existe parce qu'un flux qui répond silencieusement, indéfiniment, par rien, est exactement la panne que cet arrangement est conçu pour repérer.

Étape 1 : entrez l'adresse de votre site

Ouvrez Publication dans les paramètres de votre blog et entrez l'adresse de votre site web. Cliquez sur Trouver ma plateforme.

Nolorem vérifie si votre adresse tourne sous WordPress ou Ghost. Si c'est le cas, on vous propose directement le formulaire de connexion propre à cette plateforme au lieu des étapes ci-dessous, puisqu'un connecteur réel existe déjà pour elle.

Si rien n'est reconnu, c'est un résultat normal et attendu, pas une erreur. La plupart des sites conçus sur mesure, et tout site construit sur une plateforme pour laquelle Nolorem n'a pas de connecteur, aboutissent ici. Un court message vous le confirme, et vous êtes redirigé directement vers la déclaration de votre propre site, avec l'adresse que vous venez de saisir déjà remplie.

Étape 2 : confirmez l'adresse et le modèle d'URL

Deux champs décrivent votre site : l'adresse (confirmée à partir de ce que vous avez saisi) et le modèle d'URL des articles, la forme que prend l'URL d'un article sur votre site, par exemple /{slug} ou /blog/{slug}.

Nolorem essaie de lire une URL d'article réelle sur votre site et d'en proposer un modèle. S'il en trouve une, le champ du modèle affiche un badge Proposé avec une note indiquant sur quelle page il a été lu ; vérifiez-le par rapport à une URL dont vous savez qu'elle est correcte, puis confirmez. S'il n'en trouve pas, le champ démarre vide et vous le renseignez vous-même.

Ce champ est obligatoire, et il n'est jamais deviné en silence. Une version antérieure de cet arrangement remplissait automatiquement un modèle par défaut lorsqu'un client laissait le champ vide, et ce modèle par défaut était faux assez souvent pour envoyer les lecteurs vers une erreur 404. Nolorem exige désormais une réponse réelle, issue de la détection ou de vous-même, avant de composer le moindre lien vers un article de votre site.

Enregistrez. Votre site est désormais déclaré comme destination.

Étape 3 : créez une clé d'API de contenu

Publier sur votre propre site nécessite une clé d'API de contenu active pour que votre site ait de quoi s'authentifier. Allez dans Paramètres, Clés API et créez-en une, associée à ce blog. Consultez API de contenu public pour le parcours complet sur les portées de clé, l'authentification et chaque point de terminaison exposé par le flux ; cet article ne le répète pas.

L'API de contenu est disponible sur tout abonnement payant, y compris un essai. C'est un abonnement actif qui la débloque, pas un niveau précis.

Étape 4 : pointez votre site vers le flux

Votre site interroge GET /api/v1/posts avec la clé comme jeton bearer, puis pagine à partir de là. La manière exacte de le consommer, y compris l'interrogation économique avec If-None-Match et la copie des images vers votre propre stockage plutôt que le lien direct vers celui de Nolorem, est détaillée de bout en bout dans un script Node exécutable, sans dépendance : sync.mjs (avec son README). Téléchargez-le et utilisez-le comme point de départ.

Étape 5 : vérifiez que votre site interroge réellement le flux

De retour sur la page des paramètres de publication, la section sous votre site déclaré indique si des requêtes arrivent réellement :

• Aucune requête pour l'instant signifie que la clé existe mais n'a encore rien fait. Normal dans les minutes qui suivent la configuration ; un problème si cela persiste.
• Une requête récente indique quand le flux a été interrogé pour la dernière fois et par quelle clé.
• L'alerte apparaît lorsque votre clé a interrogé le flux à plusieurs reprises et reçu un flux vide à chaque fois. C'est exactement la situation qui était auparavant invisible : un site qui demande du contenu qui n'arrive jamais, en silence, sans que personne ne le sache. Si vous la voyez, vérifiez que la clé est associée au blog sur lequel vous publiez réellement, et que vous avez déjà publié quelque chose.

Si vous publiez dans plusieurs langues

Demandez chaque langue séparément. GET /api/v1/posts?locale=nl renvoie les mêmes articles que vous receviez déjà, mais en néerlandais là où une traduction néerlandaise complète existe, et inchangés là où il n'y en a pas. Ce n'est pas un filtre : aucun article ne disparaît parce que vous avez demandé une langue. Utilisez ?language= lorsque vous voulez réellement filtrer sur la langue dans laquelle un article a été écrit.

Chaque article indique lui-même les langues dont il dispose. available_locales les énumère et locale_slugs donne le slug que porte chaque langue. Ces slugs diffèrent réellement d'une langue à l'autre, car chacun est choisi autour du mot-clé de cette langue-là. Construisez donc votre URL par langue à partir de locale_slugs plutôt que de traduire le slug vous-même ou de réutiliser celui de la source.

Les détails, y compris ce qui se passe pour une traduction inachevée, sont dans Public Content API.

Ce que signifie "publié" dans ce contexte

Un article publié sur votre propre site affiche partout où le statut d'un article apparaît dans Nolorem la mention Disponible sur votre site au lieu de « Publié ». Ce n'est pas un statut inférieur : l'article est bien en ligne dans le flux, exactement comme pour toute autre destination. La formulation reflète simplement le fait que Nolorem lui-même ne confirme jamais que l'article a été effectivement affiché quelque part ; cette confirmation se joue entre votre site et ce qu'il fait du flux.

Changer d'avis plus tard

Si votre site change de plateforme, ou si vous passez d'un site sur mesure à WordPress ou à un autre CMS pris en charge, utilisez Changer de destination sur cette même page des paramètres de publication. Cela vous guide à travers le même parcours de migration que tout autre changement de plateforme.