DEV.to é a única plataforma de blogging à qual o Ocoya se liga. Um post DEV.to não é uma legenda social — é um Markdown article with a title, por isso comporta‑se de forma diferente de todos os outros canais.
Antes de começar
Você precisa de uma conta DEV.to e de uma chave de API gerada lá. O DEV.to não tem fluxo de autenticação para apps, por isso o Ocoya liga‑se com uma chave que você próprio gera, em vez de o enviar para o DEV.to para aprovar o acesso.
Ligar o DEV.to
Generate an API key on DEV.to
No DEV.to, vá a Settings → Extensions e gere uma chave de API. Está em dev.to/settings/extensions.
Open Channels in Ocoya
Selecione Channels, depois Connect channel, e escolha DEV.to — está listado em Blogging.
Paste the key
Cole‑a no campo DEV.to API key e confirme. O Ocoya lê o seu perfil DEV.to para dar um nome à ligação.
Como a ligação é feita por chave e não por aprovação, a revogação faz‑se no DEV.to: apague a chave em Settings → Extensions e o Ocoya deixa de conseguir aceder à conta.
O que pode publicar
Um artigo, escrito em Markdown:
- A title — obrigatório, e o ponto mais importante a acertar
- A body em Markdown, com a formatação que o DEV.to suporta
- Images, incluídas no corpo em Markdown
No video. Se anexar um, o artigo é recusado.
Os artigos DEV.to são publicados live — o Ocoya publica‑os como publicados, não como rascunhos no DEV.to.
O título
Cada artigo DEV.to precisa de um título, limitado a 128 characters.
Se você não definir um, o Ocoya usa a first line of your caption como título, removendo quaisquer marcas de heading de Markdown, por isso uma linha que comece por ## Introduction passa a Introduction em vez de mostrar os cardinal (#). Se não tiver nada de onde retirar o título, o Ocoya usa Untitled article — o que você não quer ver publicado, por isso defina um título ou comece com uma primeira linha forte.
Limites do DEV.to
| Title | 128 characters |
| Body | 100,000 characters |
| Images | 10 |
| Video | Not supported |
| Tags | Not supported from Ocoya |
O limite do corpo é uma salvaguarda do Ocoya. O limite do próprio DEV.to é 800 KB de Markdown, o que está muito além de qualquer coisa escrita num editor — o número mais baixo só significa que falha no editor em vez de falhar no momento da publicação.
Escrever para isto, não para social
A mesma legenda raramente funciona ao mesmo tempo como tweet e como artigo. Daí seguem‑se duas coisas:
- Use per-channel captions quando um post vai para DEV.to e redes sociais em conjunto. Escreva o artigo para o DEV.to e uma versão curta para o resto.
- O Markdown é renderizado, por isso headings, listas, blocos de código e links funcionam todos — e uma legenda pensada para social vai parecer pobre como artigo.
Se você publica regularmente no DEV.to, normalmente é um post separado em vez de um partilhado com os seus outros canais.
Problemas comuns
“That DEV.to API key was rejected. Generate a new key and try again.” A chave está errada, foi revogada ou foi copiada com espaços em branco. Gere uma nova em Settings → Extensions e volte a ligar.
“DEV.to articles require text.” O artigo não tem corpo. Só media não é um artigo.
“DEV.to articles cannot exceed 800 KB.” O Markdown ultrapassa o limite do próprio DEV.to — divida em mais do que um artigo.
“DEV.to is rate limiting this account. Space the scheduled articles further apart and try again.” O DEV.to limita a rapidez com que uma conta pode publicar. Aumente o intervalo entre artigos agendados em vez de enfileirar vários para a mesma hora.
“Connection to your profile has expired. Please reconnect.” Volte a ligar com uma chave atual. Veja Reconnect a channel.