init: scripts diversos (crawlers, conversores, scrapers)

doc-converter/README.md

@@ -0,0 +1,77 @@
+# 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](https://pandoc.org/installing.html)
+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.
+
+```bash
+# 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:**
+  ```bash
+  ./.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:**
+```bash
+./.venv/bin/python3 scripts/converter_final.py [CAMINHO_PARA_FICHEIRO_OU_PASTA] [OPÇÕES]
+```
+
+**Exemplos:**
+
+- **Converter um único ficheiro:**
+  ```bash
+  ./.venv/bin/python3 scripts/converter_final.py "Guias/SEO.md"
+  ```
+
+- **Converter todos os ficheiros numa pasta:**
+  ```bash
+  ./.venv/bin/python3 scripts/converter_final.py Guias/
+  ```
+
+- **Converter e forçar a recriação do template:**
+  ```bash
+  ./.venv/bin/python3 scripts/converter_final.py Guias/ --recreate-template
+  ```
+
+Os ficheiros processados serão guardados nas pastas `output/docx` e `output/pdf`.