Diagramação Automática com Pandoc + Python Passo a Passo

 

Diagramação Automática com Pandoc + Python Passo a Passo 📘


Fase 1 – Instalação do Ambiente

🔧 1.1 Instalar as ferramentas essenciais

Para Windows (usando PowerShell como administrador):

bash
# Instalar Chocolatey (se ainda não tiver) Set-ExecutionPolicy Bypass -Scope Process -Force; ` [System.Net.ServicePointManager]::SecurityProtocol = ` [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; ` iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) # Instalar dependências choco install pandoc miktex python git vscode -y pip install panflute pyyaml

🏗️ Fase 2 – Criar a Estrutura do Livro

📁 2.1 Rodar script para criar estrutura do projeto

bash
# Clonar o sistema (ou criar sua pasta) git clone https://github.com/seu-usuario/sistema-diagramacao-livros.git cd sistema-diagramacao-livros # Criar o projeto do livro python scripts/init_book.py "Título do Livro" "Seu Nome" fiction/literary

Isso criará:

lua
meu-livro/ ├── metadata.yaml ├── config.yaml ├── chapters/ │ ├── 01-capitulo.md │ └── 02-capitulo.md ├── assets/ │ └── images/ └── output/

📝 Fase 3 – Escrever o Livro

✍️ 3.1 Escrever em Markdown

markdown
# Capítulo 1: O Início {.chapter} Texto do capítulo... ## Seção Importante {.section} > Citações são formatadas automaticamente. ::: {.destaque} Informações que merecem atenção extra. :::

🎨 Fase 4 – Personalizar Metadados e Estilo

📄 4.1 Editar metadata.yaml

yaml
--- title: "Meu Livro" author: "Seu Nome" language: "pt-BR" date: "2025" cover-image: "assets/cover.jpg" ---

⚙️ 4.2 Editar config.yaml (estilo do livro)

yaml
typography: text_font: "Minion Pro" heading_font: "Trajan Pro" text_size: 11 line_spacing: 1.4 layout: page_size: "6x9" margins: top: 0.75 bottom: 0.75 inner: 0.875 outer: 0.625

🧪 Fase 5 – Testar e Visualizar

🧭 5.1 Visualização rápida:

bash
python scripts/preview_book.py meu-livro

📦 Fase 6 – Geração Final para Publicação

bash
# Compilação final com sumário interativo python scripts/build_book.py meu-livro --format=pdf,epub --production

Resultado:
📄 output/livro-final.pdf (para gráfica)
📱 output/livro-final.epub (para Kindle KDP)


🔁 Fase 7 – Ciclo Diário de Escrita

  1. Escreve novo capítulo

  2. Roda preview_book.py

  3. Valida com validate_book.py

  4. Faz backup com backup_book.py

  5. Gera EPUB/PDF com build_book.py


🌐 (Opcional) Integração com Git e Nuvem

bash
# Inicializar Git e ativar hooks automáticos git init cp scripts/git-hooks/pre-commit .git/hooks/ chmod +x .git/hooks/pre-commit # Backup para Dropbox/Google Drive python scripts/setup_cloud_sync.py meu-livro --service=gdrive

Pronto!

Comentários

Postagens mais visitadas deste blog

PASSO A PASSO PARA REGISTRAR SUAS MÚSICAS OFICIALMENTE

AÇÕES RELACIONADAS À FUSÃO NUCLEAR

Ações Selecionadas do Método Graham 11/2024