Sistemas Inteligentes e Mineração de Dados

2ª Edição: Do Weka ao Python

📘 Projeto de construção do livro de Sistemas Inteligentes e Mineração de Dados (2ª Edição)

Bem-vindo ao material didático em construção! Este livro utiliza o Quarto para integrar teoria e prática.

🚧 Status do Projeto

• Capítulos 1 e 2: Em fase de revisão final e melhorias nos exemplos em Python.
• Capítulos 3, 4 e 5: Falta incluir exemplos em Python.
• Capítulo 6: Em construção.
• Foco: Simplificar os laboratórios em Python para criar exemplos curtos, práticos e extremamente motivacionais.

📂 Estrutura Simplificada

• si-md1/: Material legado (PDF/Docx). Não editar.
• si-md2/: Pasta de trabalho ativa.
  • _quarto.yml: Configuração mestre (sumário e temas).
  • capXX/: Pasta de cada capítulo (Editar – contém o capXX.ipynb e /images).
  • references.bib: Base de dados bibliográfica global.
  • notebooks_alunos/: Versão processada para distribuição (gerada via script).

Processo:

1. Gerado si-md1/Sist_Intel_j.md de si-md1/Sist_Intel_j.docx com pandoc.
2. Copiado si-md1/Sist_Intel_j.md para si-md2/capXX/capXX.ipynb (e ajustes manuais).
3. Gerado si-md1/sistemas_inteligentes_impresso.md de si-md1/sistemas_inteligentes_impresso.pdf com tesseract.
4. Pequenas correções em si-md2/capXX/capXX.ipynb usando si-md1/sistemas_inteligentes_impresso.md.
5. Ajustes manuais para funcionar quarto render em html, pdf e epub.
6. O formato ipynb renderizado ocorre através do método gerar_notebooks_alunos.py.

flowchart TD
    %% Fontes Iniciais
    A["`**si-md1/Sist_Intel.docx**`"] -->|pandoc| B["`**si-md1/Sist_Intel.md**`"]
    C["`**si-md1/sistemas_inteligentes_impresso.pdf**`"] -->|tesseract| D["`**si-md1/sistemas_inteligentes_impresso.md**`"]

    %% Construção do Notebook Principal
    B -->|"cópia + ajustes manuais"| E["`**si-md2/capXX/capXX.ipynb**`"]
    D -->|"referência para correções"| E

    %% Fluxo de Publicação (Quarto)
    E -->|"quarto render"| F{Formatos Finalizados}
    F --> G[HTML]
    F --> I[PDF]
    F --> J[ePUB]

    %% Fluxo do Aluno (Script Python)
    E -->|gerar_notebooks_alunos.py| H["`**capXX_aluno.ipynb**`"]
    
    style H fill:#f9f,stroke:#333,stroke-width:2px
    style F fill:#e1f5fe,stroke:#01579b

---

🔄 Workflow Rápido (Terminal)

1. Atualizar: git pull origin main
2. Limpar caches: ./limpar.sh
3. Gerar Versão Aluno: python gerar_notebooks_alunos.py --batch references.bib
4. Publicar Tudo (HTML+PDF+Git): ./publish_all.sh
5. Manual (Git):

git add .
git commit -m "Explique sua alteração"
git push origin main

---

📋 Checklist de Qualidade

• Imagens estão na pasta images/ interna do capítulo?
• Labels começam com o prefixo correto (fig-, tbl-, eq-) e o número do capítulo?
• O arquivo references.bib foi atualizado com as novas obras?
• O código do notebook executa do início ao fim sem erros?

---