DEV.to ist die einzige Blogging-Plattform, mit der Ocoya sich verbindet. Ein DEV.to-Post ist keine Social-Caption — es ist ein Markdown article with a title, also verhält er sich anders als alle anderen Kanäle.
Before you start
Du brauchst ein DEV.to-Konto und einen API-Schlüssel dafür. DEV.to hat keinen Sign-in-Flow für Apps, daher verbindet sich Ocoya mit einem Schlüssel, den du selbst erzeugst, statt dich zu DEV.to zu schicken, um den Zugriff zu bestätigen.
Connect DEV.to
Generate an API key on DEV.to
In DEV.to geh zu Settings → Extensions und erstelle einen API-Schlüssel. Das ist unter dev.to/settings/extensions.
Open Channels in Ocoya
Wähle Channels, dann Connect channel, und dann DEV.to — es ist unter Blogging aufgeführt.
Paste the key
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 über einen Schlüssel und nicht über eine Bestätigung läuft, entziehst du den Zugriff auf DEV.to: Lösch den Schlüssel unter Settings → Extensions und Ocoya kann nicht mehr auf das Konto zugreifen.
What you can post
Einen Artikel, geschrieben in Markdown:
- A title — erforderlich, und das, was du richtig hinbekommen solltest
- A body in Markdown, mit dem von DEV.to unterstützten Format
- Images, im Body als Markdown eingebettet
No video. Wenn du eins anhängst, 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.
The title
Jeder DEV.to-Artikel braucht einen Titel, begrenzt auf 128 characters.
Wenn du keinen setzt, nimmt sich Ocoya die first line of your caption und verwendet sie, wobei alle Markdown-Überschriftenzeichen entfernt werden, damit aus einer Zeile ## Introduction Introduction wird und nicht die Rauten mitgedruckt werden. Wenn es gar nichts zum Verwenden gibt, fällt Ocoya auf Untitled article zurück — was du nicht veröffentlicht haben möchtest. Setz also einen Titel oder starte mit einer starken ersten Zeile.
DEV.to’s limits
| Title | 128 characters |
| Body | 100,000 characters |
| Images | 10 |
| Video | Not supported |
| Tags | Not supported from Ocoya |
Das Body-Limit ist Ocoyas Leitplanke. DEV.to selbst begrenzt auf 800 KB Markdown, was weit über allem liegt, was man in einen Composer tippt — die niedrigere Zahl bedeutet nur, dass du im Editor scheiterst statt erst beim Veröffentlichen.
Writing for it, not for social
Dieselbe Caption taugt selten gleichzeitig als Tweet und als Artikel. Daraus folgen zwei Dinge:
- Nutze per-channel captions, wenn ein Post gleichzeitig zu DEV.to und zu sozialen Netzwerken geht. Schreib den Artikel für DEV.to und eine Kurzversion für alle anderen.
- Markdown wird gerendert, sodass Überschriften, Listen, Codeblöcke und Links alle funktionieren — und eine für Social geschriebene Caption wirkt als Artikel dünn.
Wenn du regelmäßig auf DEV.to veröffentlichst, ist das in der Regel ein eigener Post und nicht einer, den du mit deinen Kanälen teilst.
Common problems
“That DEV.to API key was rejected. Generate a new key and try again.” Der Schlüssel ist falsch, wurde widerrufen oder mit Leerzeichen kopiert. Erzeuge einen neuen unter Settings → Extensions und verbinde dich erneut.
“DEV.to articles require text.” Der Artikel hat keinen Body. Nur Medien sind kein Artikel.
“DEV.to articles cannot exceed 800 KB.” Das Markdown überschreitet das DEV.to-Limit — teil es in 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 darf. Verteile geplante Artikel zeitlich, statt mehrere zur selben Zeit einzuplanen.
“Connection to your profile has expired. Please reconnect.” Stell die Verbindung mit einem aktuellen Schlüssel wieder her. Sieh dir dazu Reconnect a channel an.