DEV.to es la única plataforma de blogs a la que se conecta Ocoya. Una publicación de DEV.to no es un texto para redes sociales: es un artículo en Markdown con título, 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 aplicaciones, así que Ocoya se conecta con una clave que generas tú mismo, en lugar de enviarte a DEV.to para aprobar el acceso.
Conecta DEV.to
Genera una API key en DEV.to
En DEV.to, ve a Settings → Extensions y genera una API key. Está en dev.to/settings/extensions.
Abre Channels en Ocoya
Selecciona Channels, luego Connect channel, y elige DEV.to: aparece en Blogging.
Pega la clave
Introdúcela en el campo DEV.to API key y confirma. Ocoya lee tu perfil de DEV.to para ponerle nombre a la conexión.
Como la conexión es una clave y no una aprobación, se revoca desde DEV.to: elimina la clave en Settings → Extensions y Ocoya dejará de poder acceder a la cuenta.
Qué puedes publicar
Un artículo, escrito en Markdown:
- Un título: obligatorio, y lo más importante de cuidar
- Un cuerpo en Markdown, con el formato que admite DEV.to
- Imágenes, incluidas dentro del cuerpo como Markdown
Sin vídeo. Si adjuntas uno, el artículo se rechaza.
Los artículos de DEV.to se publican en directo: Ocoya los publica como publicados, no como borradores en DEV.to.
El título
Todo artículo de DEV.to necesita un título, limitado a 128 caracteres.
Si no pones ninguno, Ocoya toma la primera línea de tu texto y la usa como título, eliminando las marcas 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, recurre a Untitled article, que no querrás publicar, así que pon un título o empieza con una primera línea potente.
Límites de DEV.to
| Título | 128 caracteres |
| Cuerpo | 100.000 caracteres |
| Imágenes | 10 |
| Vídeo | No compatible |
| Tags | No compatibles desde Ocoya |
El límite del cuerpo es una salvaguarda de Ocoya. El tope propio de DEV.to es de 800 KB de Markdown, que está muy por encima de lo que se escribe en un compositor; el número más bajo solo hace que el fallo aparezca en el editor y no al publicar.
Escribe para DEV.to, no para redes sociales
El mismo texto rara vez sirve como tuit y como artículo. De ahí se desprenden dos cosas:
- Usa textos por canal cuando una publicación vaya a DEV.to y a redes sociales a la vez. Escribe el artículo para DEV.to y una versión corta para todo lo demás.
- El Markdown se renderiza, así que los encabezados, las listas, los bloques de código y los enlaces funcionan, y un texto escrito para redes sociales se verá escaso como artículo.
Si publicas en DEV.to con regularidad, lo habitual es que sea una publicación aparte y no una compartida con tus canales sociales.
Problemas habituales
“That DEV.to API key was rejected. Generate a new key and try again.” La clave es incorrecta, se revocó 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 cuerpo. Los archivos multimedia por sí solos no son un artículo.
“DEV.to articles cannot exceed 800 KB.” El Markdown supera el límite propio 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 rapidez con la que una cuenta puede publicar. Espacia los artículos programados en lugar de ponerlos en cola varios a la vez.
“Connection to your profile has expired. Please reconnect.” Vuelve a conectar con una clave vigente. Consulta Reconecta un canal.