DEV.to ist die einzige Blogging-Plattform, mit der sich Ocoya verbindet. Ein DEV.to-Post ist keine Social-Caption, sondern ein Markdown-Artikel mit Titel und verhält sich deshalb anders als jeder andere Kanal.
Bevor du anfängst
Du brauchst ein DEV.to-Konto und einen API-Key davon. DEV.to hat keinen Anmeldeablauf für Apps. Ocoya verbindet sich daher mit einem Key, den du selbst erzeugst, und schickt dich nicht zum Freigeben auf DEV.to.
DEV.to verbinden
Einen API-Key auf DEV.to erzeugen
Gehe in DEV.to zu Settings → Extensions und erzeuge einen API-Key. Das findest du unter dev.to/settings/extensions.
Channels in Ocoya öffnen
Wähle Channels, dann Connect channel und DEV.to. Du findest es unter Blogging.
Den Key einfügen
Füge ihn in das Feld DEV.to API key ein und bestätige. Ocoya liest dein DEV.to-Profil, um die Verbindung zu benennen.
Weil die Verbindung ein Key und keine Freigabe ist, widerrufst du sie auf DEV.to: Lösche den Key unter Settings → Extensions, und Ocoya kommt nicht mehr an das Konto.
Was du posten kannst
Einen Artikel, geschrieben in Markdown:
- Einen Titel: Pflicht und der Punkt, auf den es ankommt
- Einen Text in Markdown, mit der Formatierung, die DEV.to unterstützt
- Bilder, die als Markdown im Text stehen
Kein Video. Hängst du eines an, wird der Artikel abgelehnt.
DEV.to-Artikel werden live veröffentlicht. Ocoya veröffentlicht sie als veröffentlicht, nicht als Entwürfe auf DEV.to.
Der Titel
Jeder DEV.to-Artikel braucht einen Titel, begrenzt auf 128 Zeichen.
Wenn du keinen festlegst, nimmt Ocoya die erste Zeile deiner Caption und entfernt dabei Markdown-Überschriftszeichen, sodass aus einer Zeile mit ## Introduction die Überschrift Introduction wird und nicht die Rauten mit ausgegeben werden. Hat Ocoya nichts, woraus es einen Titel machen kann, greift es auf Untitled article zurück. Das willst du nicht veröffentlichen. Lege also einen Titel fest oder beginne mit einer starken ersten Zeile.
Die Limits von DEV.to
| Titel | 128 Zeichen |
| Text | 100.000 Zeichen |
| Bilder | 10 |
| Video | Nicht unterstützt |
| Tags | Von Ocoya aus nicht unterstützt |
Das Limit für den Text ist eine Schutzgrenze von Ocoya. Das eigene Limit von DEV.to liegt bei 800 KB Markdown, weit mehr, als man in einen Composer tippt. Die niedrigere Zahl sorgt nur dafür, dass es im Editor scheitert und nicht erst beim Veröffentlichen.
Für DEV.to schreiben, nicht für Social
Dieselbe Caption funktioniert selten sowohl als Tweet als auch als Artikel. Daraus folgt:
- Nutze Captions pro Kanal, wenn ein Post gleichzeitig an DEV.to und an soziale Netzwerke geht. Schreibe den Artikel für DEV.to und eine Kurzfassung für alles andere.
- Markdown wird gerendert, Überschriften, Listen, Code-Blöcke und Links funktionieren also. Eine Caption, die für Social geschrieben wurde, wirkt als Artikel dünn.
Wenn du regelmäßig auf DEV.to veröffentlichst, ist das meist ein eigener Post und keiner, den du mit deinen Social-Kanälen teilst.
Häufige Probleme
“That DEV.to API key was rejected. Generate a new key and try again.” Der Key ist falsch, wurde widerrufen oder mit Leerzeichen kopiert. Erzeuge unter Settings → Extensions einen neuen und verbinde erneut.
“DEV.to articles require text.” Der Artikel hat keinen Text. Medien allein sind kein Artikel.
“DEV.to articles cannot exceed 800 KB.” Das Markdown überschreitet das eigene Limit von DEV.to. Teile es auf mehrere Artikel auf.
“DEV.to is rate limiting this account. Space the scheduled articles further apart and try again.” DEV.to begrenzt, wie schnell ein Konto veröffentlichen kann. Verteile eingeplante Artikel zeitlich, statt mehrere zur selben Zeit einzureihen.
“Connection to your profile has expired. Please reconnect.” Verbinde erneut mit einem gültigen Key. Siehe Reconnect a channel.