Como funciona o blog do site (e como publicar um post)

Guia simples usando Git e GitHub

O blog deste site funciona de forma simples: todos os posts ficam armazenados em um repositório no GitHub. Quando o site é renderizado, ele automaticamente lê tudo que está dentro da pasta posts. Isso inclui arquivos .qmd e também imagens (que devem ficar em posts/img).

Ou seja, para publicar um post, basta adicionar um arquivo .qmd dentro da pasta posts. Se houver imagens, elas também devem estar dentro dessa pasta, normalmente em uma subpasta img/. A estrutura básica do repositório é a seguinte.

posts/
├── meu-post.qmd
└── img/
    └── meu-post/
        └── imagem1.png

Como publicar um post

De forma geral, o processo para publicar um post no blog envolve alguns passos simples. Primeiro, é necessário ter uma conta no GitHub, já que é lá que o conteúdo do site fica armazenado. Em seguida, você deve instalar e configurar o Git no seu computador, que é a ferramenta responsável por enviar arquivos para o repositório. Depois disso, basta clonar o repositório do site para sua máquina, adicionar o novo arquivo .qmd (e eventuais imagens na pasta correta), registrar as alterações e enviá-las de volta ao GitHub. Uma vez feito o envio, o site poderá incorporar automaticamente o novo conteúdo na próxima renderização.

A etapa de configurar as credenciais do GitHub localmente tem alguns detalhes importantes. Assim, citamos materiais auxiliares para usuários de Linux e Windows.

Em resumo:

• O blog lê automaticamente a pasta posts
• Para publicar: adicionar .qmd + imagens
• Usar Git: clone -> add -> commit -> push

Tutorial de Quarto

Um breve tutorial de como escrever arquivos em quarto markdown está disponível aqui.