Sobre o projeto

Este repositório contém o código-fonte de um blog e site pessoal que é gerado como um site estático com Jekyll e o tema Chirpy. O site é publicado através do GitHub Pages, e o README aponta para o site principal, uma implantação de desenvolvimento/prévia separada e um índice de documentação externo. Organização do conteúdo O blog agrega postagens de diversas fontes históricas, incluindo o site atual, um grupo de sites GitHub Pages relacionados ao Kubernetes e dois blogs mais antigos focados em Linux, cujo conteúdo data de 2009. O README tabula a distribuição de postagens por fonte e ano, e lista 14 categorias e 55 tags com contagens por fonte. Áreas temáticas recorrentes incluem Linux, Kubernetes, networking, cloud, security, DevOps, OpenWrt, virtualização, storage, Android, fotografia e Windows. As contagens de tags mostram quais tópicos aparecem com mais frequência, como kubernetes, amazon-eks, security, eksctl, bash, cert-manager, wifi e pxe. Páginas de índice de categorias e tags são geradas para que as postagens possam ser navegadas por tópico. Tematização e geração do site O site é baseado no tema open-source Chirpy, e o README contém links tanto para o repositório do tema quanto para um site complementar que descreve dicas e melhores práticas para utilizá-lo. Ferramentas de build e qualidade Builds locais podem ser reproduzidos em um container: o comando documentado instala as ferramentas de build, Ruby e Bundler, e então executa bundle install e jekyll build com a saída direcionada para o diretório public. O linting é tratado pelo MegaLinter, que pode ser executado através de seu runner com uma flag de validação em todo o codebase. Dois fluxos de trabalho do GitHub Actions são exibidos via badges de status: um para linting do codebase e outro para build e implantação no GitHub Pages. O projeto também exibe badges do OpenSSF Scorecard e OpenSSF Best Practices, indicando a participação nesses programas de saúde de projeto e cadeia de suprimentos. Convenções de teste O README documenta um comando de teste baseado em container que instala utilitários e Docker, configura o gerenciador de ferramentas mise com plugins e tarefas adicionais, e então invoca uma tarefa de criação de postagem. Uma convenção em torno de blocos de código delimitados controla o que acontece no fluxo de teste de postagens: blocos de código marcados como bash são executados durante a fase de criação, blocos marcados como sh são executados durante a fase de limpeza ou destruição, e blocos marcados como shell são apenas exibidos nas páginas renderizadas e nunca executados. Isso permite que postagens em estilo de tutorial sirvam também como cenários executáveis. Notas e limites O repositório é um projeto de site e conteúdo, e não uma aplicação ou biblioteca reutilizável. Suas capacidades documentadas limitam-se à geração de site estático, categorização de conteúdo, builds baseados em container, configuração de linter, fluxos de CI e execução de comandos orientada por convenções dentro das postagens.