My new Blog

Deploy

Started

This project is my person notebook where I'm describ about my studies on Linux Programming and Quality. This is not a tutorials. This is my daily study, buildin my portfolio know.

Well ok. Where from this idea? Good, this ideia emerge from the book The Programatic Programmer. Specifically, of the chapter one get to know the book here.

Testando localmente

Pré-requisitos: Hugo extended 0.147.9+ e Go (só é usado pra baixar o tema via Hugo Modules, não tem código Go no projeto). Se preferir não instalar nada na sua máquina, o repo já vem pronto pra abrir num Dev Container (.devcontainer/) ou no Gitpod — os dois sobem o ambiente completo (Hugo, Go, Ruby) sozinhos.

git clone https://github.com/kellen-xavier/ladydebug.github.io.git
cd ladydebug.github.io

# baixa o tema (Hextra) via Hugo Modules
hugo mod tidy

# sobe o servidor local com live reload
hugo server -D -F

Abra http://localhost:1313/. -D mostra posts marcados como draft: true e -F mostra posts com data no futuro — assim dá pra revisar tudo antes de publicar. Qualquer mudança em content/, layouts/, assets/ ou data/ recarrega a página sozinha.

Antes de abrir um PR, vale rodar também o lint e um build de produção igual ao do CI, pra pegar erro de template que só aparece com --minify:

hugo --gc --minify

Lint de Markdown

Os posts são checados com o mdl (regras em .mdl_style.rb). Roda automaticamente em todo PR e push para develop/main (.github/workflows/lint.yaml); para rodar localmente:

bundle install
bundle exec mdl content README.md

O mdl só aponta os problemas, não corrige. Pra corrigir automaticamente o que dá pra corrigir sem risco (ver scripts/fix_markdown.rb pra saber exatamente o quê):

bundle exec ruby scripts/fix_markdown.rb

Changelog e releases

O CHANGELOG.md (formato Keep a Changelog) é gerado automaticamente pelo git-cliff a partir dos commits em Conventional Commits (feat:, fix:, ...). Não é para editar esse arquivo manualmente.

Quando develop é mergeada em main, o workflow .github/workflows/release.yaml:

1. calcula a próxima versão a partir dos commits desde a última tag;
2. atualiza o CHANGELOG.md e commita em main;
3. cria a tag vX.Y.Z e publica a GitHub Release com as notas dessa versão.

Se não houver commit relevante (feat/fix/...) desde a última tag, nada é publicado.

Doca (dock) do rodapé

Barra fixa no rodapé com janelas flutuantes (<dialog>, arrastáveis, sem libs), no estilo desktop/OS do fim dos anos 2000. Fica isolada do resto do tema em arquivos próprios:

• data/dock.yaml — quais botões existem, rótulo, ícone e link do Spotify.
• data/events.yaml — lista de próximos eventos do painel "Calendário".
• content/drafts/ — rascunhos (hugo new drafts/nome.md); cada um vira uma página própria, mas fica fora do blog, do RSS e do sitemap.
• assets/css/desktop-dock.css e assets/js/desktop-dock.js — estilo e comportamento, separados do custom.css/tema.

Pra trocar o link do Spotify ou adicionar um evento, é só editar os .yaml acima — não precisa mexer nos templates.

Ícones: Pixelarticons (MIT).

Fonte: Pixelify Sans (OFL, licença em assets/font/pixelify-sans/OFL.txt), self-hosted como WOFF2 — usada só dentro da doca e das janelas, não no resto do site. Emitida via layouts/partials/custom/head-end.html (não dá pra usar url() relativo direto no desktop-dock.css, que é um CSS puro, sem processamento de Hugo).