DEV.to es la única plataforma de blogging con la que se conecta Ocoya. Una publicación de DEV.to no es un pie de foto social: es un Markdown article with a title, así que se comporta de forma distinta a cualquier otro canal.
Antes de empezar
Necesitas una cuenta de DEV.to y una API key de esa cuenta. DEV.to no tiene un flujo de inicio de sesión para apps, así que Ocoya se conecta con una clave que generas tú mismo en lugar de enviarte a DEV.to para aprobar el acceso.
Conectar DEV.to
Generate an API key on DEV.to
En DEV.to, ve a Settings → Extensions y genera una API key. Está en dev.to/settings/extensions.
Open Channels in Ocoya
Selecciona Channels, luego Connect channel, y elige DEV.to — aparece en Blogging.
Paste the key
Pégala en el campo DEV.to API key y confirma. Ocoya lee tu perfil de DEV.to para nombrar la conexión.
Como la conexión se basa en una clave y no en una aprobación, revocarla se hace en DEV.to: borra la clave en Settings → Extensions y Ocoya ya no podrá acceder a la cuenta.
Qué puedes publicar
Un artículo, escrito en Markdown:
- A title: obligatorio, y lo más importante que debes acertar
- A body en Markdown, con el formato que admite DEV.to
- Images, incluidas dentro del body como Markdown
No video. Si adjuntas uno, el artículo se rechazará.
Los artículos de DEV.to se publican live: Ocoya los publica como publicados, no como borradores en DEV.to.
El título
Cada artículo de DEV.to necesita un título, con un máximo de 128 caracteres.
Si no estableces uno, Ocoya toma la first line of your caption y la usa, eliminando cualquier marca de encabezado de Markdown, de modo que una línea que empiece por ## Introduction se convierte en Introduction en lugar de mostrar las almohadillas. Si no tiene nada de lo que partir, usa Untitled article — algo que no quieres que se publique, así que pon un título o empieza con una primera línea potente.
Límites de DEV.to
| Title | 128 characters |
| Body | 100,000 characters |
| Images | 10 |
| Video | Not supported |
| Tags | Not supported from Ocoya |
El límite del body es una barandilla de seguridad de Ocoya. El tope propio de DEV.to es 800 KB de Markdown, que está muy por encima de cualquier cosa que se teclee en un editor: el número más bajo solo significa que fallarás en el editor y no en el momento de publicar.
Escribir para esto, no para redes sociales
El mismo pie de foto rara vez funciona como tweet y como artículo a la vez. De ahí se derivan dos cosas:
- Usa per-channel captions cuando una publicación vaya a DEV.to y a redes sociales al mismo tiempo. Escribe el artículo para DEV.to y una versión breve para el resto.
- Markdown se renderiza, así que los encabezados, listas, bloques de código y enlaces funcionan — y un pie de foto escrito para redes se verá pobre como artículo.
Si publicas en DEV.to con frecuencia, normalmente será una publicación aparte en lugar de compartirla con tus otros canales.
Problemas habituales
“That DEV.to API key was rejected. Generate a new key and try again.” La clave es incorrecta, se ha revocado o se copió con espacios en blanco. Genera una nueva en Settings → Extensions y vuelve a conectar.
“DEV.to articles require text.” El artículo no tiene body. Solo medios no constituyen un artículo.
“DEV.to articles cannot exceed 800 KB.” El Markdown ha superado el límite de DEV.to: divídelo en más de un artículo.
“DEV.to is rate limiting this account. Space the scheduled articles further apart and try again.” DEV.to limita la velocidad a la que una cuenta puede publicar. Separa más en el tiempo las publicaciones programadas en lugar de poner varias en cola a la vez.
“Connection to your profile has expired. Please reconnect.” Vuelve a conectar con una clave actual. Consulta Reconnect a channel.