Veröffentlichen auf deiner eigenen Website

Nolorem veröffentlicht über eigene APIs auf WordPress, Ghost und Webflow. Ist deine Website keine davon, muss sie es auch nicht sein. Erkläre sie zu deiner eigenen Website, und Nolorem wird dafür ein vollwertiges Veröffentlichungsziel, genau wie jede andere Anbindung.

Dieser Artikel führt dich durch die Einrichtung ab dem ersten Tag, von Anfang bis Ende. Er setzt nichts über den technischen Aufbau deiner Website voraus, außer dass sie eine HTTP-Anfrage entgegennehmen kann.

Was diese Vereinbarung eigentlich bedeutet

Lies das zuerst, denn es bestimmt, wie du die Gegenseite aufbaust.

Nolorem ruft deine Website niemals auf. Es gibt keinen Webhook, keinen Push, keinen Callback. Deine Website ruft Nolorem auf, nach dem Zeitplan, den du wählst. Die Public Content API ist ein schreibgeschützter Feed: deine Website fragt ihn ab, und alles Weitere, einschließlich wie oft, liegt bei dir.

Nolorem sagt dir, wenn bei deiner eigenen Einrichtung etwas nicht stimmt. Ist deine Website erklärt, aber nichts ruft sie ab, oder ruft etwas ab und bekommt nichts zurück, wird das auf der Seite Veröffentlichungseinstellungen angezeigt, statt unsichtbar zu bleiben. Der Abschnitt weiter unten zum Prüfen, ob deine Website tatsächlich abruft, ist kein Nebenaspekt; er existiert, weil ein Feed, der still, für immer, mit nichts antwortet, genau der Fehler ist, gegen den diese Vereinbarung gebaut wurde.

Schritt 1: Gib die Adresse deiner Website ein

Öffne Veröffentlichung in den Einstellungen deines Blogs und gib die Adresse deiner Website ein. Klicke auf Meine Plattform finden.

Nolorem prüft, ob deine Adresse auf WordPress oder Ghost läuft. Ist das der Fall, wird dir statt der folgenden Schritte gleich das eigene Verbindungsformular dieser Plattform angeboten, da dafür bereits eine echte Anbindung existiert.

Wird nichts erkannt, ist das ein normales, erwartetes Ergebnis und kein Fehler. Die meisten individuell gebauten Websites, und jede Website auf einer Plattform, für die Nolorem keine Anbindung hat, landen hier. Du erhältst eine kurze Meldung, die das bestätigt, und wirst direkt zum Erklären deiner eigenen Website weitergeleitet, mit der gerade eingegebenen Adresse bereits ausgefüllt.

Schritt 2: Bestätige die Adresse und das URL-Muster

Zwei Felder beschreiben deine Website: die Adresse (bestätigt aus deiner Eingabe) und das URL-Muster für Beiträge, die Form, in der die URL eines einzelnen Beitrags auf deiner Website aussieht, zum Beispiel /{slug} oder /blog/{slug}.

Nolorem versucht, eine echte Artikel-URL von deiner Website zu lesen und daraus ein Muster vorzuschlagen. Findet es eine, zeigt das Musterfeld eine Kennzeichnung Vorschlag mit einem Hinweis, von welcher Seite es gelesen wurde; Prüfe es gegen eine URL, von der du weißt, dass sie stimmt, und bestätige dann. Findet es keine, beginnt das Feld leer, und du trägst es selbst ein.

Dieses Feld ist erforderlich, und es wird niemals stillschweigend geraten. Eine frühere Version dieser Vereinbarung trug automatisch ein Standardmuster ein, wenn ein Kunde das Feld unberührt ließ, und dieses Standardmuster war oft genug falsch, um Leser zu einer 404-Seite zu schicken. Nolorem besteht jetzt auf einer echten Antwort, aus Erkennung oder von dir, bevor auch nur ein Link zu einem Beitrag auf deiner Website erstellt wird.

Speichern. Deine Website ist nun als Ziel erklärt.

Schritt 3: Erstelle einen Content-API-Schlüssel

Das Veröffentlichen auf deiner eigenen Website benötigt einen aktiven Content-API-Schlüssel, damit sich deine Website authentifizieren kann. Geh zu Einstellungen, API Keys und erstelle einen, gebunden an diesen Blog. Den vollständigen Ablauf zu Schlüsselbereichen, Authentifizierung und jedem Endpunkt, den der Feed bereitstellt, findest du unter Public Content API; dieser Artikel wiederholt ihn nicht.

Die Content API ist auf jedem kostenpflichtigen Plan verfügbar, auch während einer Testphase. Ein aktives Abonnement schaltet sie frei, keine bestimmte Stufe.

Schritt 4: Richte deine Website auf den Feed aus

Deine Website ruft GET /api/v1/posts mit dem Schlüssel als Bearer-Token ab und paginiert von dort aus. Wie das genau geht, einschließlich sparsamem Abfragen mit If-None-Match und dem Kopieren von Bildern in deinen eigenen Speicher statt sie von Nolorem zu verlinken, wird vollständig in einem lauffähigen, abhängigkeitsfreien Node-Skript durchgespielt: sync.mjs (mit dem zugehörigen README). Lade es herunter und nutze es als Ausgangspunkt.

Schritt 5: Prüfe, ob deine Website tatsächlich abruft

Zurück auf der Seite Veröffentlichungseinstellungen zeigt der Abschnitt unter deiner erklärten Website, ob wirklich Anfragen eingehen:

• Noch keine Anfragen bedeutet, dass der Schlüssel existiert, aber noch nicht verwendet wurde. Normal in den Minuten nach der Einrichtung; ein Problem, wenn es dabei bleibt.
• Eine kürzliche Anfrage zeigt, wann der Feed zuletzt abgerufen wurde und von welchem Schlüssel.
• Die Warnung erscheint, wenn dein Schlüssel wiederholt abgerufen und dabei jedes Mal einen leeren Feed zurückbekommen hat. Genau das war früher unsichtbar: eine Website, die nach Inhalten fragt, die nie ankommen, still, ohne dass es jemand erfährt. Sieh diese Warnung, prüfe, ob der Schlüssel dem Blog zugeordnet ist, auf dem du tatsächlich veröffentlichst, und ob du bereits etwas veröffentlicht hast.

Wenn du in mehr als einer Sprache veröffentlichst

Frage jede Sprache einzeln ab. GET /api/v1/posts?locale=nl gibt dieselben Beiträge zurück, die du ohnehin bekamst, aber auf Niederländisch, wo eine vollständige niederländische Übersetzung existiert, und unverändert, wo es keine gibt. Es ist kein Filter: Kein Beitrag verschwindet, weil du eine Sprache angefragt hast. Nutze ?language=, wenn du tatsächlich nach der Sprache filtern willst, in der ein Beitrag geschrieben wurde.

Jeder Beitrag sagt dir selbst, welche Sprachen er hat. available_locales listet sie auf, und locale_slugs nennt den Slug, den jede Sprache trägt. Diese Slugs unterscheiden sich wirklich je Sprache, denn jeder ist rund um das Keyword genau dieser Sprache gewählt. Baue deine URL pro Sprache also aus locale_slugs, statt den Slug selbst zu übersetzen oder den der Quellsprache wiederzuverwenden.

Die Einzelheiten, auch was mit einer noch nicht fertigen Übersetzung geschieht, stehen in Public Content API.

Was "veröffentlicht" hier bedeutet

Ein auf deiner eigenen Website veröffentlichter Beitrag zeigt überall, wo der Status eines Beitrags in Nolorem erscheint, Für deine Website verfügbar statt "Veröffentlicht" an. Das ist kein geringerer Status: Der Beitrag ist live im Feed, genau wie bei jedem anderen Ziel. Die Formulierung spiegelt nur wider, dass Nolorem selbst nie bestätigt, dass der Beitrag irgendwo dargestellt wurde; diese Bestätigung liegt zwischen deiner Website und dem, was sie mit dem Feed macht.

Später umentscheiden

Wechselt deine Website die Plattform, oder zieh von einer individuell gebauten Website auf WordPress oder ein anderes unterstütztes CMS um, nutze Ziel ändern auf derselben Seite Veröffentlichungseinstellungen. Das führt dich durch denselben Migrationsablauf wie jeder andere Plattformwechsel.