title	published	description	tags	canonical_url	cover_image	series
Título do post - obrigatório	false		tag1, ptbr, opcional

Gerencie seus post do dev.to através do Github

Sumário

• 1️⃣ Template
• 2️⃣ Ajuste o package.json
• 3️⃣ Dev-to-git token
• 4️⃣ Crie um post vazio
• 5️⃣ ID do post
• 6️⃣ Escreva o post
• ❗️ Informações importantes
• ❓ Preciso de ajuda

---

1️⃣ Template

Clique no botão Use this template no topo desse repositório para que seja gerado um repositório na sua conta com os mesmos arquivos desse modelo.

2️⃣ Ajuste o package.json

É preciso ajustar os valores abaixo para que a biblioteca dev-to-git consiga enviar as imagens do diretório images/ corretamente.

Vá no arquivo package.json e altere o campo url informando os seus dados.

  "repository": {
    "type": "git",
    "url": "https://github.com/SEU-USUARIO/SEU-REPOSITORIO.git"
  }

3️⃣ Dev-to-git token

É preciso passar um token para o Github para que o dev-to-git tenha acesso à sua conta, atualizando os seus posts.

Acesse a página de configuração da conta do dev.to para gerar um token a ser utilizado.

Informe uma descrição para o token, clique em Generate APi Key e copie o token gerado.

Em seguida, no seu repositório do Github, vá em Settings > Secrets e clique em Add a new secret. Cadastre um segredo com o nome DEV_TO_GIT_TOKEN e inserindo no valor o token copiado anteriormente.

NUNCA compartilhe o token gerado

4️⃣ Crie um post vazio

Essa etapa é necessária pois dev-to-git não cria um novo post, apenas atualiza post existente.

Vá no dev.to, clique em WRITE A POST, preencha o título e o conteúdo do post com qualquer texto e clique em SAVE DRAFT para salvar como rascunho.

5️⃣ ID do post

Agora é preciso informar o ID dessa página para que seja possível atualizar a mesma.

Com o post aberto, envie o comando F12 para abrir a tela de desenvolvedor. Vá na aba Console e envie o comando abaixo para que capture o ID do post.

$('div[data-article-id]').getAttribute('data-article-id')

Com o ID copiado, vá no arquivo dev-to-git.json e altere o valor do campo id com o do seu post.

[
  {
    "id": 214298,
    "relativePathToArticle": "./README.md"
  }
]

6️⃣ Escreva o post

Pronto 🎉, você já possui tudo configurado para escrever o seu post. Toda vez que atualizar o README o post será atualizado no dev.to.

---

❗️ Informações importantes

• O README.md é composto de 2 seções:

  1. Cabeçalho, com informações sobre o seu post, como título, se deve ser publicado ou não e tags. Para saber mais, veja a seção Front Matter do Guia do editor.
  2. Post em si, que deve ser escrito abaixo do cabeçalho.

• Caso vá colocar imagem que não seja através de URL, armazene ela no diretório images e referencie no seu post.

• O build de atualização do post é executado apenas se o commit for feito na branch master. Para saber mais, veja o arquivo de configuração do build.

---

❓ Preciso de ajuda

Está com algum problema e precisa de ajuda? Abra uma issue aqui detalhando a sua situação e irei te ajudar.