scripts/doc-converter

Gerador de Guias DOCX e PDF

Este projeto automatiza a conversão de guias de marketing escritos em Markdown para documentos .docx e .pdf com branding profissional.

Funcionalidades

• Conversão de Markdown: Converte ficheiros .md para .docx e .pdf.
• Branding Automático: Aplica um template DOCX com cabeçalhos, rodapés e estilos pré-definidos.
• Índice (TOC): Gera automaticamente um índice no início do documento, intitulado "Índice".
• Preservação de Links: Mantém todos os hyperlinks do ficheiro Markdown original.
• Processamento em Lote: Consegue processar um único ficheiro ou uma pasta inteira de ficheiros .md.

Pré-requisitos

Para utilizar este projeto, precisa de ter as seguintes ferramentas instaladas no seu sistema:

1. Pandoc: Para a conversão de documentos.
   • Instruções de Instalação
2. LibreOffice: Para a conversão de DOCX para PDF.
   • No Ubuntu/Debian: sudo apt install libreoffice
3. Python 3: Com o módulo venv.
   • No Ubuntu/Debian: sudo apt install python3 python3-venv

Como Utilizar

1. Configuração do Ambiente

Primeiro, clone o repositório e navegue para a pasta do projeto. Em seguida, crie um ambiente virtual e instale as dependências Python.

# Criar o ambiente virtual
python3 -m venv .venv

# Instalar as dependências do projeto
./.venv/bin/pip install -r scripts/requirements.txt

2. Preparar o Template (Opcional)

O script utiliza um template otimizado para Pandoc (scripts/template_pandoc.docx). Se o template mestre (scripts/template_mestre.docx) for alterado, precisa de recriar o template para Pandoc.

Pode fazê-lo de duas formas:

• Manualmente, executando o script:

  ./.venv/bin/python3 scripts/create_pandoc_template.py
  

• Automaticamente, ao converter: Adicione a flag --recreate-template ao comando de conversão.

3. Executar a Conversão

Para converter os guias, execute o script converter_final.py, passando o caminho para o ficheiro ou pasta que deseja processar.

Sintaxe do Comando:

./.venv/bin/python3 scripts/converter_final.py [CAMINHO_PARA_FICHEIRO_OU_PASTA] [OPÇÕES]

Exemplos:

• Converter um único ficheiro:

  ./.venv/bin/python3 scripts/converter_final.py "Guias/SEO.md"
  

• Converter todos os ficheiros numa pasta:

  ./.venv/bin/python3 scripts/converter_final.py Guias/
  

• Converter e forçar a recriação do template:

  ./.venv/bin/python3 scripts/converter_final.py Guias/ --recreate-template
  

Os ficheiros processados serão guardados nas pastas output/docx e output/pdf.