DEV.to est la seule plateforme de blog à laquelle Ocoya se connecte. Un post DEV.to n’est pas une légende de réseau social : c’est un article en Markdown avec un titre, il se comporte donc différemment de tous les autres canaux.
Avant de commencer
Il vous faut un compte DEV.to et une clé d’API de ce compte. DEV.to n’a pas de connexion pour les applications : Ocoya se connecte avec une clé que vous générez vous-même, au lieu de vous envoyer sur DEV.to pour approuver l’accès.
Connecter DEV.to
Générer une clé d'API sur DEV.to
Dans DEV.to, allez dans Settings → Extensions et générez une clé d’API. Elle se trouve sur dev.to/settings/extensions.
Ouvrir Channels dans Ocoya
Sélectionnez Channels, puis Connect channel, et choisissez DEV.to : il figure sous Blogging.
Coller la clé
Placez-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é et non sur une approbation, la révoquer se fait sur DEV.to : supprimez la clé dans Settings → Extensions et Ocoya ne peut plus accéder au compte.
Ce que vous pouvez publier
Un article, rédigé en Markdown :
- Un titre : obligatoire, et c’est l’élément à soigner
- Un corps en Markdown, avec la mise en forme prise en charge par DEV.to
- Des images, intégrées dans le corps en Markdown
Pas de vidéo. Si vous en joignez une, l’article est refusé.
Les articles DEV.to sont publiés en direct : Ocoya les publie comme publiés, pas 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 : une ligne commençant par ## Introduction devient Introduction au lieu d’afficher les dièses. Sans rien à exploiter, il se rabat sur Untitled article, ce que vous ne voulez pas voir publié : définissez un titre ou ouvrez sur une première ligne accrocheuse.
Les limites de DEV.to
| Titre | 128 caractères |
| Corps | 100 000 caractères |
| Images | 10 |
| Vidéo | Non prise en charge |
| Tags | Non pris en charge depuis Ocoya |
La limite du corps est un garde-fou d’Ocoya. Le plafond de DEV.to est de 800 KB de Markdown, bien au-delà de ce qu’on saisit dans un compositeur : la limite plus basse fait simplement que l’erreur survient dans l’éditeur plutôt qu’à 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. Deux conséquences :
- Utilisez les légendes par canal quand un post part à la fois vers DEV.to et des réseaux sociaux. Rédigez l’article pour DEV.to et une version courte pour le reste.
- Le Markdown est interprété : titres, listes, blocs de code et liens fonctionnent, et une légende écrite pour les réseaux sociaux paraîtra maigre en article.
Si vous publiez régulièrement sur DEV.to, il vaut généralement mieux créer un post distinct plutôt que d’en partager un avec vos canaux sociaux.
Problèmes courants
“That DEV.to API key was rejected. Generate a new key and try again.” La clé est incorrecte, 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. Un média seul n’est pas un article.
“DEV.to articles cannot exceed 800 KB.” Le Markdown dépasse la limite de DEV.to : répartissez-le en plusieurs articles.
“DEV.to is rate limiting this account. Space the scheduled articles further apart and try again.” DEV.to limite la vitesse à laquelle un même compte peut publier. Espacez les articles planifiés plutôt que d’en mettre plusieurs en file en même temps.
“Connection to your profile has expired. Please reconnect.” Reconnectez-vous avec une clé valide. Voir Reconnecter un canal.