Borto.log

Introdução No processo de desenvolvimento de software, é comum e até recomendado fazer commits pequenos e frequentes. No entanto, nem todos esses commits são “perfeitos” para serem enviados diretamente para a branch principal (main ou master). Muitas vezes, criamos commits intermediários com código quebrado, funcionalidades incompletas, ou mensagens de commit provisórias (“WIP - Work In Progress”). O desafio surge quando queremos um histórico de commits limpo, coeso e fácil de entender para a main branch, mas também precisamos da flexibilidade de “salvar” nosso trabalho provisoriamente para testar novas abordagens ou voltar a um ponto específico. ...

Introdução O git patch é uma ferramenta poderosa para compartilhar mudanças em seu código-fonte sem a necessidade de um repositório remoto. Ele permite que você “empacote” commits ou alterações não versionadas em um arquivo de texto simples (.patch) que pode ser enviado por e-mail, transferido via USB, ou compartilhado de qualquer outra forma, e então aplicado por outra pessoa em seu próprio repositório Git. É extremamente útil em cenários como: ...

Introdução Este post explica em detalhe como configurei o sistema de comentários do blog usando Giscus (frontend) com GitHub Discussions (backend) sobre uma base Hugo + PaperMod. É um complemento prático ao post de setup inicial, com justificativas, pré-requisitos, passos reproduzíveis e a solução adotada para sincronizar o tema do Giscus com o toggle de tema do PaperMod. O objetivo é que você consiga replicar o mesmo fluxo no seu repositório e entender as decisões e gargalos que enfrentei. ...

Introdução Neste post explico como configurei o fluxo de deploy do site Hugo usando o Cloudflare Pages, com ambientes separados para staging e production. O projeto usa: Hugo com o tema PaperMod config/_default/ para base comum config/staging/ para staging config/production/ para produção Branches do Git para escolher o ambiente automaticamente Por que usar staging no Cloudflare Pages Staging é útil para: validar conteúdo antes de publicar testar layout e integrações em um domínio seguro evitar deploys acidentais no site principal No meu caso, o staging roda em https://staging.bortoloso.me/ e a produção em https://bortoloso.me/. ...

Por que assinar commits? Assinar commits no Git garante que o autor e o conteúdo não foram alterados desde a criação, é uma prova criptográfica ligada a uma chave privada. Sem assinatura, qualquer pessoa com acesso ao repositório (ou que consiga forjar user.name/user.email) pode criar commits que aparentam ser seus, o que dificulta auditoria e confiança no histórico. Em repositórios pessoais, assinaturas trazem confiança no seu próprio histórico e permitem checar se um commit foi realmente gerado por você. Em ambientes profissionais, reduz-se o risco de supply-chain attacks e facilita atribuição correta de mudanças críticas. ...

Este post documenta, passo a passo, como configurei o blog BORTO.LOG até o momento. Serve como referência para mim e para quem quiser reproduzir a mesma stack: Hugo + tema PaperMod, versionado no GitHub, publicado via Cloudflare Pages. Sumário rápido Propósito e decisão da stack Pré-requisitos Estrutura do repositório e convenções Comandos para desenvolvimento local Configuração do build e deploy no Cloudflare Pages Sistema de comentários com Giscus Notas e decisões Propósito Criei este blog como um caderno técnico pessoal: anotações, tutoriais, experimentos e documentação do meu dia a dia como engenheiro/desenvolvedor. Precisei de algo rápido para gerar HTML estático, com suporte a temas modernos, boa performance e sem dependências pesadas, por isso escolhi Hugo =)… e por outras razões pessoais. ...