1 Motivação
Criei este blog para registrar e compartilhar o que estou estudando e aprendendo em computação, funcionando como um repositório onde compilo minhas descobertas. A cada post, meu objetivo é documentar e dividir o que aprendo, bem como os desafios que encontro, enquanto ajudo outros que também estão explorando essa área. Aqui, você encontrará conteúdos que abrangem uma ampla gama de tópicos, desde noções básicas até conceitos mais avançados e especializados, apresentados por meio de tutoriais práticos, explicações detalhadas e dicas valiosas para quem busca expandir suas habilidades em tecnologia.
2 Construção do Blog
2.1 Quarto
O Quarto é um sistema open source para publicação científica e técnica, construído sobre o Pandoc, um poderoso conversor de arquivos entre diferentes formatos de marcação. Veja na Figura 1 o funcionamento do Quarto, que combina células de código executável e Markdown em um arquivo .qmd. Quando um arquivo .qmd é renderizado, os blocos de código são processados pelo Jupyter e o resultado, junto ao restante do Markdown, é convertido em um Markdown simples (.md). O Pandoc permite transformar esse documento em uma enorme variedade de formatos de saída (All formats), como HTML, PDF e Microsoft Word, etc.
2.2 Blog
O Quarto inclui suporte para criação de blogs de forma fácil e simples (Creating a Blog), com uma diversidade de temas e personalizações. Cada postagem é escrita em formato Markdown, um formato de texto simples e fácil de escrever, e em seguida é convertida para HTML. Informações adicionais, como título, subtítulo, autor, categorias e data de cada documento, são fornecidas no formato YAML no início do próprio arquivo Markdown. Confira a forma de instalação no seu sistema operational (Download Quarto). Com o Quarto é muito fácil criar o projeto de um blog, basta usar o comando quarto create project com o parâmetro blog, especificando o diretório do projeto no argumento seguinte (Comando 1). E para renderizar o blog, use o quarto preview. Isso permitirá visualizar o conteúdo no navegador (Comando 2).
Terminal
quarto create project blog <path-to-project>Terminal
quarto preview <path-to-project>Existem diversas formas de escrever documentos no Quarto (Tutorial: Hello, Quarto). Estou usando o VSCodium, um popular ambiente de desenvolvimento, o que facilita a escrita em um ambiente voltado para programadores. O Quarto disponibiliza uma Extensão para o VSCode, que inclui diversas ferramentas que facilitam o trabalho com documentos Quarto, como renderização e visualização integradas, syntax highlighting para Markdown. Além disso, a extensão oferece autocomplete tanto para opções YAML quanto para linguagens como Python, R e Julia, facilitando a escrita de código. E também conta com comandos e atalhos de teclado para execução de células e linhas selecionadas, bem como pré-visualização para matemática LaTeX e diagramas Mermaid e Graphviz. O uso do VSCode não é obrigatório — é possível escrever documentos no Quarto utilizando outras ferramentas, como Jupyter, RStudio, Neovim, Emacs, Sublime Text ou qualquer outro editor de sua preferência.
Cada post conta com uma seção de referências bibliográficas, para que você possa explorar mais a fundo os materiais e fontes utilizados. O Quarto usa o Pandoc para gerar automaticamente citações e bibliografia em arquivos no formato BibLaTeX (.bib) ou BibTeX (.bibtex) (Citations). As citações e a bibliografia são formatadas usando a Citation Style Language, arquivos (.csl). Por padrão, o Pandoc usa o formato autor-data do Chicago Manual of Style, mas é possível alterá-lo. O repositório do Zotero disponibiliza uma variedade de estilos de citação. Estou utilizando o estilo da Associação Brasileira de Normas Técnicas (ABNT), que pode ser encontrado aqui.
Além da seção de referências bibliográficas, cada post também inclui uma seção de comentários, onde os leitores podem discutir, perguntar e complementar o conteúdo, promovendo a troca de ideias e experiências, o que torna o processo de aprendizado mais interativo e colaborativo. O Quarto possibilita adicionar comentários ao final de cada publicação (Quarto Comentários). Dentre as opções disponíveis está o Giscus, um sistema de comentários open source, que permite que os visitantes deixem comentários e reações nas suas publicações via um repositório do GitHub. Nenhum banco de dados é necessário, todos os dados são armazenados no GitHub Discussions, um fórum de comunicação colaborativo para a comunidade de um projeto.
2.3 Publicação
Há uma grande variedade de maneiras de publicar documentos, apresentações e sites criados usando o Quarto (Publishing Basics). Este blog está hospedado no GitHub Pages, um serviço de hospedagem de sites que permite publicar conteúdo com base no código-fonte gerenciado em um repositório do GitHub. O Quarto disponibiliza o GitHub Actions for Quarto para construir e publicar automaticamente seus documentos Quarto sempre que você enviar alterações ao seu repositório. Confira o arquivo YAML que usei para fazer o build e o deploy no GitHub Pages aqui.
3 Conclusão
Antes de escolher o Quarto para desenvolver este blog, experimentei diversas ferramentas e até comecei a criá-lo usando apenas o Pandoc. No entanto, gerenciar cada postagem manualmente se mostrou trabalhoso. Com certeza, o Quarto se mostrou uma ótima escolha, pois já oferece toda a estrutura pronta para um blog, facilitando o gerenciamento das postagens de forma simples e intuitiva. Confira o repositório deste blog para mais detalhes sobre o código e a implementação. Se você gostou da personalização que fiz neste blog, sinta-se à vontade para criar o seu próprio, fazendo um fork e modificando-o como quiser. Antes de começar a escrever seu primeiro post, recomendo a leitura:
Confira as referências para mais detalhes sobre o funcionamento do Quarto e do Pandoc. Caso queira, deixe seu complemento, dúvida, sugestão ou correção sobre o assunto na seção de comentários no final desta página.