feat: aprimorar geração de eBooks e adicionar referências

- Atualiza o workflow de geração de eBooks para incluir novas opções de formatação.
- Adiciona a extração e consolidação de referências no script de geração.
- Cria um novo arquivo CSS para estilização do eBook em EPUB.
- Corrige referências em capítulos existentes.
- Gera novos arquivos PDF e EPUB com as alterações.

Author: josenaldo

.github/workflows/generate-ebook.yml

@@ -47,7 +47,9 @@ jobs:
             --pdf-engine=xelatex \
             --toc \
             --toc-depth=2 \
-            -V geometry:margin=1in \
+            --number-sections \
+            -V geometry:top=2.5cm,bottom=2.5cm,left=3cm,right=2.5cm \
+            -V linestretch=1.3 \
             -V documentclass=book \
             -V lang=pt-BR \
             -V mainfont="DejaVu Serif" \
@@ -62,6 +64,9 @@ jobs:
             -o public/downloads/livro-pog.epub \
             --toc \
             --toc-depth=2 \
+            --number-sections \
+            --epub-cover-image=public/images/cover/capa.jpg \
+            --css=public/styles/ebook.css \
             --metadata title="Programação Orientada a Gambiarra" \
             --metadata author="Josenaldo Matos Filho" \
             --metadata lang=pt-BR

content/capitulos/requisitos/dimensao-humana.md

@@ -47,7 +47,7 @@ Esse profissional ostenta capacidades excepcionais de produção de sistemas em
 
 O que muita gente não sabe é que o Arquiteto MacGyver é um mestre no uso de geradores de POGramas, frameworks e todas as artimanhas necessárias pra criar um calhamaço de POG que pareça resolver o problema proposto. E o projeto gerado por este profissional, apesar de impressionar à primeira vista, costuma apodrecer mais rápido que que fruta em mochila de POGramador.
 
-O Arquiteto MacGyver costuma ter um relacionamento dúbio com a equipe, ora atuando com fonte de inspiração para ideias pseudodisruptivas, ora atuando como fonte  de inspiração para impropérios capazes de fazer o próprio Moonwalker de Curupira[^fn-nomes-capeta] corar de vergonha.
+O Arquiteto MacGyver costuma ter um relacionamento dúbio com a equipe, ora atuando com fonte de inspiração para ideias pseudodisruptivas, ora atuando como fonte  de inspiração para impropérios capazes de fazer o próprio Moonwalker de Curupira[^fn-nomes-capeta-1] corar de vergonha.
 
 ## Gerente Sem Noção
 
@@ -94,23 +94,23 @@ Obviamente que isso vira um círculo vicioso, onde mais pogs são necessárias p
 
 ## Intrometido Inepto
 
-Pra completar a corte enviada pelo Estraga Suruba[^fn-nomes-capeta], temos o Intrometido Inepto. Essa figura aparece em diversas fases do projeto com uma única missão: se intrometer onde não é chamado para fornecer uma opinião não solicitada sobre um assunto que não domina.
+Pra completar a corte enviada pelo Estraga Suruba[^fn-nomes-capeta-2], temos o Intrometido Inepto. Essa figura aparece em diversas fases do projeto com uma única missão: se intrometer onde não é chamado para fornecer uma opinião não solicitada sobre um assunto que não domina.
 
 O Intrometido Inepto costuma colaborar na criação de pogs ao colocar ideias perniciosas nas mentes de tomadores de decisões despreparados para lidar com essa influência danosa.
 
-É esse filho do Chinelo Emborcado[^fn-nomes-capeta] que planta, na mente fértil do Gerente Sem Noção, a ideia de que seria muito útil se o sistema financeiro tivesse uma funcionalidade de geração aleatória de nomes do capeta no campo de nomes dos fornecedores.
+É esse filho do Chinelo Emborcado[^fn-nomes-capeta-3] que planta, na mente fértil do Gerente Sem Noção, a ideia de que seria muito útil se o sistema financeiro tivesse uma funcionalidade de geração aleatória de nomes do capeta no campo de nomes dos fornecedores.
 
-É esse Torresmo de Prepúcio[^fn-nomes-capeta] que, num ato de covardia e prazer pelo sofrimento alheio, convence o cliente de que o sistema precisa ter a capacidade de enviar emails através de pombos-correio, caso a internet caia.
+É esse Torresmo de Prepúcio[^fn-nomes-capeta-4] que, num ato de covardia e prazer pelo sofrimento alheio, convence o cliente de que o sistema precisa ter a capacidade de enviar emails através de pombos-correio, caso a internet caia.
 
-É esse Tempero de Miojo[^fn-nomes-capeta] que diz para o Gerente Sem Noção que a equipe vai render muito mais se for marcada uma palestra motivacional com coach quântico numa sexta feira, às 18h30. E sem lanche, pois a fome é uma motivadora muito fote.
+É esse Tempero de Miojo[^fn-nomes-capeta-5] que diz para o Gerente Sem Noção que a equipe vai render muito mais se for marcada uma palestra motivacional com coach quântico numa sexta feira, às 18h30. E sem lanche, pois a fome é uma motivadora muito fote.
 
 Se você identificar um Intrometido Inepto junto aos tomadores de decisão associados ao seu projeto, a atitude mais correta e humana é capturar e entregar para o Ibama. Se isso não for possível, reze. Se for ateu, essa é uma boa hora pra adotar uma religião.
 
 ## Dobrador de problemas
 
 Ao tratarmos da dimensão humana, não poderíamos deixar de mencionar um papel que pode ser assumido por qualquer um dos membros dessa pequena seita de invocação de calamidades digitais: o Dobrador de Problemas.
 
-Não se sabe qual fenômeno causa essa transfiguração na criatura humana. O que se sabe é que, em qualquer momento de um projeto, o espírito do Dobrador de Problemas pode encarnar em seu avatar (que poder ser qualquer um, mas quase sempre é o gerente) e esse passa controlar os problemas da equipe com toda destreza e graciosidade do Nariz Fora da Máscara[^fn-nomes-capeta] tentando causar um pequeno apocalipse.
+Não se sabe qual fenômeno causa essa transfiguração na criatura humana. O que se sabe é que, em qualquer momento de um projeto, o espírito do Dobrador de Problemas pode encarnar em seu avatar (que poder ser qualquer um, mas quase sempre é o gerente) e esse passa controlar os problemas da equipe com toda destreza e graciosidade do Nariz Fora da Máscara[^fn-nomes-capeta-6] tentando causar um pequeno apocalipse.
 
 Tal qual um Jesus da Desgracença, o Dobrador de Problemas pega um pequeno empecilho pra resolver e, a partir desse minúsculo pedacinho de caos, ele gera um tufão de esmerdalhamento que multiplica e joga problemas pra todos os lados, fazendo o efeito Asa de Urubu parecer um folheto de igreja que mostra uma criança loira montando um leão vegano.
 
@@ -122,7 +122,17 @@ Quem será o próximo a ser possuído?[^fn-next-problem-bender]
 
 ## Notas
 
-[^fn-nomes-capeta]: Moonwalker de Curupira é um dos nomes do Virose Bacteriana, do Discurso Epistemológico, do Farofa Doce, do Azuado, do Pai da Mentira, do Filho do Presidente, do Fede a 17... Para mais nomes, visite [Invocador de Nomes do Capeta](https://invocapiroto.com.br)
+[^fn-nomes-capeta-1]: Moonwalker de Curupira é um dos nomes do Virose Bacteriana, do Discurso Epistemológico, do Farofa Doce, do Azuado, do Pai da Mentira, do Filho do Presidente, do Fede a 17... Para mais nomes, visite [Invocador de Nomes do Capeta](https://invocapiroto.com.br)
+
+[^fn-nomes-capeta-2]: Estraga Suruba é outro nome do capeta. Ver nota 1.
+
+[^fn-nomes-capeta-3]: Chinelo Emborcado é outro nome do capeta. Ver nota 1.
+
+[^fn-nomes-capeta-4]: Torresmo de Prepúcio é outro nome do capeta. Ver nota 1.
+
+[^fn-nomes-capeta-5]: Tempero de Miojo é outro nome do capeta. Ver nota 1.
+
+[^fn-nomes-capeta-6]: Nariz Fora da Máscara é outro nome do capeta. Ver nota 1.
 
 [^fn-next-problem-bender]: Certeza que é o gerente. É sempre o gerente.
 

public/downloads/livro-pog.epub

@@ -0,0 +1,156 @@
+/* EPUB Custom Stylesheet for Programação Orientada a Gambiarra */
+
+/* Body and Typography */
+body {
+  font-family: Georgia, "Times New Roman", serif;
+  line-height: 1.6;
+  margin: 1em;
+  text-align: justify;
+}
+
+/* Headings */
+h1 {
+  font-size: 2em;
+  margin-top: 1.5em;
+  margin-bottom: 0.8em;
+  page-break-before: always;
+  text-align: center;
+  font-weight: bold;
+}
+
+h2 {
+  font-size: 1.5em;
+  margin-top: 1.2em;
+  margin-bottom: 0.6em;
+  font-weight: bold;
+}
+
+h3 {
+  font-size: 1.2em;
+  margin-top: 1em;
+  margin-bottom: 0.5em;
+  font-weight: bold;
+}
+
+/* Paragraphs */
+p {
+  margin: 0.8em 0;
+  text-indent: 1.5em;
+}
+
+/* First paragraph after heading - no indent */
+h1 + p,
+h2 + p,
+h3 + p {
+  text-indent: 0;
+}
+
+/* Lists */
+ul, ol {
+  margin: 1em 0;
+  padding-left: 2em;
+}
+
+li {
+  margin: 0.5em 0;
+}
+
+/* Blockquotes */
+blockquote {
+  margin: 1em 2em;
+  padding: 0.5em 1em;
+  border-left: 3px solid #666;
+  font-style: italic;
+  background-color: #f5f5f5;
+}
+
+/* Code */
+code {
+  font-family: "Courier New", Courier, monospace;
+  background-color: #f5f5f5;
+  padding: 0.2em 0.4em;
+  border-radius: 3px;
+}
+
+pre {
+  background-color: #f5f5f5;
+  padding: 1em;
+  overflow-x: auto;
+  border-radius: 5px;
+  margin: 1em 0;
+}
+
+pre code {
+  background-color: transparent;
+  padding: 0;
+}
+
+/* Links */
+a {
+  color: #0066cc;
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+/* Images */
+img {
+  max-width: 100%;
+  height: auto;
+  display: block;
+  margin: 1em auto;
+}
+
+/* Footnotes */
+.footnote {
+  font-size: 0.9em;
+  vertical-align: super;
+}
+
+.footnotes {
+  margin-top: 2em;
+  padding-top: 1em;
+  border-top: 1px solid #ccc;
+  font-size: 0.9em;
+}
+
+/* Tables */
+table {
+  border-collapse: collapse;
+  width: 100%;
+  margin: 1em 0;
+}
+
+th, td {
+  border: 1px solid #ddd;
+  padding: 0.5em;
+  text-align: left;
+}
+
+th {
+  background-color: #f5f5f5;
+  font-weight: bold;
+}
+
+/* Page breaks */
+.page-break {
+  page-break-after: always;
+}
+
+/* Strong and emphasis */
+strong {
+  font-weight: bold;
+}
+
+em {
+  font-style: italic;
+}
+
+/* Horizontal rules */
+hr {
+  border: none;
+  border-top: 1px solid #ccc;
+  margin: 2em 0;
+}

public/downloads/livro-pog.pdf

@@ -31,7 +31,9 @@ if [ "$FORMAT" == "pdf" ] || [ "$FORMAT" == "all" ]; then
         --pdf-engine=xelatex \
         --toc \
         --toc-depth=2 \
-        -V geometry:margin=1in \
+        --number-sections \
+        -V geometry:top=2.5cm,bottom=2.5cm,left=3cm,right=2.5cm \
+        -V linestretch=1.3 \
         -V documentclass=book \
         -V lang=pt-BR \
         -V mainfont="DejaVu Serif" \
@@ -53,6 +55,10 @@ if [ "$FORMAT" == "epub" ] || [ "$FORMAT" == "all" ]; then
         -o /workspace/downloads/livro-pog.epub \
         --toc \
         --toc-depth=2 \
+        --number-sections \
+        --epub-cover-image=/workspace/images/cover/capa.jpg \
+        --epub-embed-font=/workspace/styles/ebook.css \
+        --css=/workspace/styles/ebook.css \
         --metadata title="Programação Orientada a Gambiarra" \
         --metadata author="Josenaldo Matos Filho" \
         --metadata lang=pt-BR

public/styles/ebook.css

@@ -57,24 +57,55 @@ function fixImagePaths(content) {
   return content.replace(/!\[([^\]]*)\]\(\/images\//g, '![$1](./images/');
 }
 
+// Extract references from content (without removing)
+function extractReferences(content) {
+  // Match from "## Referências" to the next "##" (not "###") or "[^" or end
+  const referencesMatch = content.match(/## Referências\s*\n([\s\S]*?)(?=\n## [^#]|\n\[^[^\]]|$)/);
+  if (referencesMatch && referencesMatch[1].trim()) {
+    // Clean up the references section
+    return referencesMatch[1].trim().replace(/^---+\s*$/gm, ''); // Remove horizontal rules
+  }
+  return null;
+}
+
 // Generate combined markdown
 function generateCombinedMarkdown() {
   const chapters = getChapters();
   let combinedContent = '';
+  const allReferences = [];
 
-  // Add title page
+  // Add title page with metadata
   combinedContent += '---\n';
   combinedContent += 'title: Programação Orientada a Gambiarra\n';
+  combinedContent += 'subtitle: Um Guia Definitivo sobre a Arte da Gambiarra no Desenvolvimento de Software\n';
   combinedContent += 'author: Josenaldo Matos Filho\n';
+  combinedContent += 'date: 2024\n';
   combinedContent += 'lang: pt-BR\n';
+  combinedContent += 'rights: © 2024 Josenaldo Matos Filho. Licenciado sob CC BY-NC-SA 4.0\n';
+  combinedContent += 'description: |\n';
+  combinedContent += '  Um livro satírico sobre as gambiarras no desenvolvimento de software,\n';
+  combinedContent += '  explorando técnicas, princípios e padrões da POGramação.\n';
+  combinedContent += 'keywords: [programação, gambiarra, humor técnico, padrões de projeto, desenvolvimento de software]\n';
+  combinedContent += 'publisher: Auto-publicado\n';
   combinedContent += '---\n\n';
 
   // Add each chapter
   chapters.forEach((chapter, index) => {
     console.log(`Adding chapter ${index + 1}/${chapters.length}: ${chapter.title} (${chapter.path})`);
 
+    let chapterContent = chapter.content;
+    
+    // Extract and collect references (keep them in chapter)
+    const references = extractReferences(chapterContent);
+    if (references) {
+      allReferences.push({
+        chapter: chapter.title,
+        references: references
+      });
+    }
+    
     combinedContent += `# ${chapter.title}\n\n`;
-    combinedContent += fixImagePaths(chapter.content);
+    combinedContent += fixImagePaths(chapterContent);
     combinedContent += '\n\n';
 
     // Add page break for PDF
@@ -83,10 +114,24 @@ function generateCombinedMarkdown() {
     }
   });
 
+  // Add consolidated references at the end if any exist
+  if (allReferences.length > 0) {
+    combinedContent += '\\newpage\n\n';
+    combinedContent += '# Bibliografia Consolidada\n\n';
+    combinedContent += 'Esta seção consolida todas as referências citadas ao longo do livro, organizadas por capítulo.\n\n';
+    
+    allReferences.forEach(ref => {
+      combinedContent += `## ${ref.chapter}\n\n`;
+      combinedContent += ref.references;
+      combinedContent += '\n\n';
+    });
+  }
+
   // Write combined file
   fs.writeFileSync(OUTPUT_FILE, combinedContent, 'utf-8');
   console.log(`\nGenerated combined markdown: ${OUTPUT_FILE}`);
   console.log(`Total chapters: ${chapters.length}`);
+  console.log(`References consolidated: ${allReferences.length} chapters`);
 }
 
 // Run