O DEV.to é a única plataforma de blogging a que o Ocoya se liga. Uma publicação no DEV.to não é uma legenda de rede social: é um artigo em Markdown com título, por isso comporta-se de forma diferente de todos os outros canais.
Antes de começar
Precisa de uma conta DEV.to e de uma chave de API dessa conta. O DEV.to não tem um fluxo de início de sessão para aplicações, por isso o Ocoya liga-se com uma chave que gera você mesmo, em vez de o enviar para o DEV.to para aprovar o acesso.
Ligue o DEV.to
Gere uma chave de API no DEV.to
No DEV.to, vá a Settings → Extensions e gere uma chave de API. Está em dev.to/settings/extensions.
Abra Channels no Ocoya
Selecione Channels, depois Connect channel, e escolha DEV.to, que está listado em Blogging.
Cole a chave
Coloque-a no campo DEV.to API key e confirme. O Ocoya lê o seu perfil do DEV.to para dar nome à ligação.
Como a ligação é feita com uma chave e não com uma aprovação, a revogação faz-se no DEV.to: apague a chave em Settings → Extensions e o Ocoya deixa de poder aceder à conta.
O que pode publicar
Um artigo, escrito em Markdown:
- Um título: obrigatório, e o ponto que mais convém acertar
- Um corpo em Markdown, com a formatação que o DEV.to suporta
- Imagens, incluídas no corpo em Markdown
Sem vídeo. Se anexar um, o artigo é recusado.
Os artigos do DEV.to são publicados em direto: o Ocoya publica-os como publicados, não como rascunhos no DEV.to.
O título
Todos os artigos do DEV.to precisam de um título, limitado a 128 caracteres.
Se não definir um, o Ocoya usa a primeira linha da sua legenda, removendo as marcas de cabeçalho Markdown, para que uma linha que comece por ## Introduction passe a Introduction em vez de mostrar os cardinais. Sem nada a que recorrer, usa Untitled article, que não é o que quer ver publicado, por isso defina um título ou comece com uma boa primeira linha.
Limites do DEV.to
| Título | 128 caracteres |
| Corpo | 100 000 caracteres |
| Imagens | 10 |
| Vídeo | Não suportado |
| Tags | Não suportadas a partir do Ocoya |
O limite do corpo é uma salvaguarda do Ocoya. O limite do próprio DEV.to é de 800 KB de Markdown, muito acima de tudo o que se escreve num compositor, e o número mais baixo serve apenas para que a falha aconteça no editor e não no momento da publicação.
Escrever para o DEV.to, não para as redes sociais
A mesma legenda raramente funciona como tweet e como artigo. Daqui resultam duas coisas:
- Use legendas por canal quando uma publicação vai para o DEV.to e para redes sociais em simultâneo. Escreva o artigo para o DEV.to e uma versão curta para o resto.
- O Markdown é interpretado, por isso cabeçalhos, listas, blocos de código e ligações funcionam, e uma legenda escrita para redes sociais vai parecer fraca como artigo.
Se publica no DEV.to com regularidade, o mais habitual é ser uma publicação separada e não uma partilhada com os seus canais sociais.
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. Gere uma nova em Settings → Extensions e volte a ligar.
“DEV.to articles require text.” O artigo não tem corpo. Só com multimédia não há artigo.
“DEV.to articles cannot exceed 800 KB.” O Markdown ultrapassa o limite do próprio DEV.to. Divida-o 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. Espace os artigos agendados em vez de colocar vários na fila ao mesmo tempo.
“Connection to your profile has expired. Please reconnect.” Volte a ligar com uma chave atual. Consulte Volte a ligar um canal.