Projeto do Site

Visão Geral

Este é o primeiro projeto documentado, sobre o desenvolvimento do blog.

Tecnologias Utilizadas

• Hugo & Hextra
• Docker & Docker Compose
• GitHub Actions
• GitHub Pages
• Python
• Go

Sobre

Este projeto é sobre o desenvolvimento do próprio site, que está sendo escrito em Markdown e utilizando o Hugo para gerar as páginas estáticas. O site está sendo desenvolvido com o objetivo de compartilhar conhecimento e experiências sobre desenvolvimento de software, projetos da faculdade, documentações e entre outros. Meio que insperado no blog do akita.

Tambem tenho outro de portifolio focado em frontend, logo devo praticar mais em react. caso queira ver, estara disponivel no link: Portifolio.

O Desafio Inicial

O ponto de partida para este projeto foi a necessidade de criar um local centralizado para documentar minha jornada. Inicialmente, utilizava uma variedade de ferramentas, como cadernos, arquivos .md no obsidian — que eu amo, mas tornavam difícil acompanhar meu progresso e compartilhar conhecimento com clareza.

Por que Hugo/Hextra? e porque não Notion ou Obsidian publish?

A escolha por Hugo e Hextra como ferramenta principal foi motivada por sua simplicidade e velocidade. Como um desenvolvedor, valorizo a eficiência e a capacidade de focar no conteúdo sem me preocupar com a complexidade da infraestrutura. O Hugo se destaca nesse aspecto, permitindo criar sites estáticos de forma rápida e segura. É claro, controle total e customização é algo que eu gosto bastante, e o Hugo me proporciona isso.

Sobre o notion e o obsidian publish, eu gosto muito de ambos, mas não me agradam muito na questão de liberdade e customização. Por exemplo, no notion, eu não consigo customizar ao maximo, apesar de ele ser muito bom, e no obsidian publish, ele é muito generico. Alem disso, ambos são pagos, e eu queria uma solução gratuita, open source, e que me desse um desafio.

A Arquitetura

A arquitetura do projeto foi pensada para facilitar a colaboração e a automação. O uso de Docker e Docker Compose garante que o ambiente de desenvolvimento seja consistente em diferentes máquinas, enquanto o GitHub Actions cuida da publicação automática das alterações, tornando o processo de deploy quase imperceptível.

Alem de ferramentas criadas como os scripts, e dev.sh, inspiração do blog do akita que é um hub/menu para o terminal, e generate_index.py uma inspiração de thyagobrejao, que inclusive tem um blog feito tambem em hugo/hextra, que realiza a atualização da pagina index.

Tecnologias e Ferramentas

Hextra

A escolha do tema Hextra para o site foi crucial para definir a identidade visual e a experiência do usuário. Sua flexibilidade permite personalizar a aparência do blog de acordo com as necessidades do projeto, mantendo a estética limpa e profissional.

inclusive, fiz algumas alterações no tema original para melhor se adequar às minhas necessidades, como uma fonte feita para deslexia e alteração do tema escuro. Ainda tenho que alterar algumas coisas.

O Processo de Desenvolvimento

O desenvolvimento do site foi um processo contínuo. A documentação foi um dos principais objetivos deste projeto. Queria ter um registro claro dos desafios encontrados e das soluções aplicadas, o que acaba servindo como referência para projetos futuros.

Interações e Feedback

As interações é algo a ser planejado, irei utilizar as discussões no github para interações.

Benefícios e Resultados

Os benefícios do projeto foram percebidos rapidamente. O blog se tornou um espaço onde posso organizar minhas ideias, documentar projetos e compartilhar conhecimento de forma estruturada. Além disso, o processo de desenvolvimento me permitiu aprofundar meus conhecimentos em Hugo, Docker e GitHub Actions, e tambem em python com os scripts.

Crescimento Pessoal

Este projeto também representou um crescimento pessoal significativo. Ao documentar meus projetos, sinto que estou construindo um legado, algo que pode ser útil para mim mesmo no futuro e para outros desenvolvedores que possam encontrar o blog.

Planos Futuros

Os planos futuros para o blog incluem a adição de mais conteúdo, como tutoriais detalhados, estudos de caso e análises de tecnologias emergentes. Além disso, pretendo explorar mais as funcionalidades do Hugo e do Hextra para melhorar a experiência do usuário e adicionar novos recursos ao site. Traduzir para o inglês é o foco para mais tarde.

Expansão para Outras Linguagens de Programação

Por agora irei deixar como estar, mas a ideia mais tarde é reescrever o site em outra linguagem de programação como rust, react, etc. Para isso acontecer, preciso dar uma avaliada e testes.