Gerador de sites estáticos com "Make" (2022)

• Artigo sobre como usar o "Make" como gerador de sites estáticos; a ferramenta vem ganhando popularidade por sua simplicidade, velocidade e baixa manutenção.
• O autor, Karl Bartel, compartilha sua experiência ao configurar um blog com um script simples, o que ele considerou mais satisfatório do que usar outros criadores de sites.
• A configuração básica inclui colocar todos os arquivos de entrada no diretório de origem, adicionar um cabeçalho a todos os arquivos HTML durante o processamento e copiar todos os outros arquivos, sem alterações, para o diretório de build.
• O autor fornece regras de Makefile para cada etapa ao executar make build, o que gera um diretório de build que pode ser navegado localmente ou enviado para um servidor web.
• O artigo também discute como estender a configuração básica para atender a várias necessidades, como indicar a página atual, gerar páginas a partir de Markdown ou adicionar recursos de conveniência.
• Exemplos desses recursos de conveniência incluem servir o site localmente usando o servidor web embutido do Python, reconstruir automaticamente o site quando arquivos no diretório de origem forem alterados ou enviar o site para o GitHub Pages.
• O autor destaca as vantagens de ter seu próprio gerador de sites estáticos no Makefile, incluindo a ausência de dependências estranhas, manutenção fácil e adaptação rápida às próprias necessidades.
• Um exemplo real de página construída com essa abordagem está disponível em https://github.com/karlb/astridbartel.de.

[GN⁺]

Comentários no Hacker News

• Artigo sobre a discussão de usar o Make como gerador de site estático
• Um usuário compartilha sua experiência pessoal usando um Makefile para gerar um site, acrescentando recursos como notícias, feeds RSS, listas automáticas de publicações de pesquisa e materiais de aula, e relata que isso tem funcionado de forma eficaz
• O usuário menciona o uso de hooks do git para chamar make automaticamente quando necessário no servidor remoto onde o site está hospedado
• Outro usuário aponta um problema dessa abordagem: mesmo que arquivos sejam excluídos da fonte, eles não são removidos no build. Ele sugere como contorno apagar toda a pasta de build antes de reconstruir, mas isso anula o propósito do sistema de build
• Um usuário sugere adicionar m4 para aumentar a flexibilidade, mas observa que essa abordagem pode não funcionar em grandes sites atuais porque exige proficiência em HTML entre os colaboradores
• Um usuário compartilha como criou seu gerador de site estático (SSG) minimalista, barf, inspirado no trabalho de Karl com o script shell blog.sh
• Outro usuário observa que, se você já está fazendo push para o GitHub, pode enviar o código-fonte e deixar o GitHub publicar o Markdown como páginas hospedadas
• Um usuário elogia o fato de que a maioria dos blogs de desenvolvedores vistos no Hacker News tem feeds RSS e compartilha o hábito de seguir feeds de todos os artigos interessantes que lê
• Um usuário compartilha uma história sobre sua experiência usando make para gerar artigos científicos: ao alterar um único arquivo de teste, ele consegue regenerar o artigo inteiro, incluindo executar testes e gerar gráficos
• Um usuário argumenta que o make é útil para programas grandes compilados por compiladores lentos, permitindo rebuilds incrementais rápidos, mas que, no caso de sites estáticos que podem ser gerados rapidamente, um script pode ser mais eficiente
• Um usuário compartilha sua experiência de ter usado scripts shell antes de migrar para um Makefile, concluindo que isso era mais adequado. Ele também menciona o uso de templates XSLT para gerar páginas, índices e feeds Atom
• Um usuário, que usa Linux e scripts shell há mais de 20 anos mas não programa muito, pergunta por que make é preferido em vez de scripts shell e compartilha o hábito de usar scripts para organizar e atualizar a página principal de aulas após criar um site com o Zim-wiki