DEV.to est la seule plateforme de blog à laquelle Ocoya se connecte. Un post DEV.to n’est pas une légende sociale — c’est un Markdown article with a title, donc il se comporte différemment de tous les autres canaux.
Avant de commencer
Vous avez besoin d’un compte DEV.to et d’une clé API issue de celui-ci. DEV.to n’a pas de flux de connexion pour les applications, donc Ocoya se connecte avec une clé que vous générez vous-même plutôt qu’en vous envoyant sur DEV.to pour approuver l’accès.
Connecter DEV.to
Generate an API key on DEV.to
Dans DEV.to, allez à Settings → Extensions et générez une clé API. C’est à l’adresse dev.to/settings/extensions.
Open Channels in Ocoya
Sélectionnez Channels, puis Connect channel, et choisissez DEV.to — il est répertorié sous Blogging.
Paste the key
Collez-la dans le champ DEV.to API key et confirmez. Ocoya lit votre profil DEV.to pour nommer la connexion.
Comme la connexion repose sur une clé plutôt que sur une approbation, sa révocation se fait sur DEV.to : supprimez la clé dans Settings → Extensions et Ocoya ne pourra plus atteindre le compte.
Ce que vous pouvez publier
Un article, rédigé en Markdown :
- A title — obligatoire, et l’élément à soigner
- A body en Markdown, avec la mise en forme que DEV.to prend en charge
- Images, intégrées dans le corps en Markdown
No video. Si vous en joignez une, l’article est refusé.
Les articles DEV.to sont publiés en direct — Ocoya les publie comme publiés, et non comme brouillons sur DEV.to.
Le titre
Chaque article DEV.to a besoin d’un titre, limité à 128 caractères.
Si vous n’en définissez pas, Ocoya prend la première ligne de votre légende et l’utilise, en retirant les marques de titre Markdown : ainsi, une ligne commençant par ## Introduction devient Introduction plutôt que d’afficher les dièses. S’il n’y a rien à utiliser, Ocoya se rabat sur Untitled article — ce que vous ne voulez pas voir publié. Définissez donc un titre ou commencez par une première ligne percutante.
Les limites de DEV.to
| Title | 128 characters |
| Body | 100,000 characters |
| Images | 10 |
| Video | Not supported |
| Tags | Not supported from Ocoya |
La limite du corps est un garde-fou d’Ocoya. Le plafond propre à DEV.to est de 800 KB de Markdown, ce qui est bien au-delà de tout ce qui serait tapé dans un éditeur — le nombre plus bas signifie simplement que vous échouez dans l’éditeur plutôt qu’au moment de la publication.
Écrire pour DEV.to, pas pour les réseaux sociaux
La même légende fonctionne rarement à la fois comme tweet et comme article. Il en découle deux choses :
- Utilisez les légendes par canal lorsqu’un post est envoyé à DEV.to et aux réseaux sociaux en même temps. Rédigez l’article pour DEV.to et une version courte pour tous les autres.
- Le Markdown est interprété, donc les titres, listes, blocs de code et liens fonctionnent tous — et une légende écrite pour les réseaux sociaux paraîtra bien maigre en tant qu’article.
Si vous publiez régulièrement sur DEV.to, il s’agit en général d’un post séparé plutôt que d’un post partagé avec vos autres canaux.
Problèmes courants
“That DEV.to API key was rejected. Generate a new key and try again.” La clé est erronée, a été révoquée ou a été copiée avec des espaces. Générez-en une nouvelle dans Settings → Extensions et reconnectez-vous.
“DEV.to articles require text.” L’article n’a pas de corps. Des médias seuls ne constituent pas un article.
“DEV.to articles cannot exceed 800 KB.” Le Markdown dépasse la limite propre à DEV.to — scindez-le en plusieurs articles.
“DEV.to is rate limiting this account. Space the scheduled articles further apart and try again.” DEV.to limite la fréquence de publication d’un même compte. Espacez davantage les articles programmés plutôt que d’en aligner plusieurs au même moment.
“Connection to your profile has expired. Please reconnect.” Reconnectez-vous avec une clé à jour. Voir Reconnect a channel.