79 lines
2.9 KiB
Markdown
79 lines
2.9 KiB
Markdown
# MarkdownConverter - Aggiornamenti
|
|
|
|
## Nuova Funzionalità: Conversione Batch
|
|
|
|
### Descrizione
|
|
È stata aggiunta una nuova funzionalità che permette di convertire automaticamente più file Markdown in un unico documento DOCX e/o PDF.
|
|
|
|
### Interfaccia a Tab
|
|
L'applicazione ora presenta due tab:
|
|
|
|
#### 1. **Conversione Singola**
|
|
- La funzionalità originale per convertire singoli file Markdown
|
|
- Supporta l'uso di template con placeholder personalizzati
|
|
- Gestione dei profili per diversi tipi di documenti
|
|
- Conversione diretta a DOCX o PDF
|
|
- Possibilità di convertire DOCX in PDF
|
|
|
|
#### 2. **Conversione Batch**
|
|
- Conversione automatica di più file Markdown da una cartella
|
|
- I file devono seguire il pattern di numerazione: `01_*.md`, `02_*.md`, ecc.
|
|
- Combinazione automatica dei file in ordine alfabetico
|
|
- Generazione di un singolo DOCX con tutti i contenuti
|
|
- Opzione per generare anche il PDF finale
|
|
- Supporto per template DOCX (senza placeholder, come riferimento di stile)
|
|
|
|
### Utilizzo della Conversione Batch
|
|
|
|
1. **Seleziona la Cartella**
|
|
- Clicca su "Sfoglia..." per selezionare la cartella contenente i file Markdown
|
|
- I file devono essere numerati: `01_introduzione.md`, `02_capitolo1.md`, ecc.
|
|
|
|
2. **Configura le Opzioni**
|
|
- **Nome base output**: Il nome del file risultante (senza estensione)
|
|
- **Usa template DOCX**: Attiva per usare un template come riferimento di stile
|
|
- **Genera anche PDF finale**: Attiva per convertire automaticamente il DOCX in PDF
|
|
|
|
3. **Genera il Documento**
|
|
- Clicca su "Genera Documento"
|
|
- Controlla il log per vedere i progressi
|
|
- I file verranno salvati nella stessa cartella dei file sorgente
|
|
|
|
### Funzioni Core Aggiunte
|
|
|
|
Nel modulo `markdownconverter/core/core.py` sono state aggiunte due nuove funzioni:
|
|
|
|
#### `combine_markdown_files(markdown_files, output_path)`
|
|
Combina più file Markdown in un unico file.
|
|
|
|
**Parametri:**
|
|
- `markdown_files`: Lista di Path o stringhe che puntano ai file markdown
|
|
- `output_path`: Percorso dove salvare il file combinato
|
|
|
|
**Ritorna:**
|
|
- Percorso del file combinato
|
|
|
|
#### `convert_markdown_to_docx_with_pandoc(input_file, output_path, template_path=None)`
|
|
Converte Markdown in DOCX usando Pandoc con template opzionale.
|
|
Questa è una conversione più semplice senza sostituzione di placeholder.
|
|
|
|
**Parametri:**
|
|
- `input_file`: Percorso del file markdown
|
|
- `output_path`: Percorso dove salvare il DOCX
|
|
- `template_path`: Percorso opzionale a un template DOCX (reference-doc)
|
|
|
|
**Ritorna:**
|
|
- Percorso del file DOCX generato
|
|
|
|
### Note Tecniche
|
|
|
|
- La funzionalità batch è completamente isolata nel modulo `batch_converter.py`
|
|
- Utilizza le stesse funzioni core per la conversione PDF
|
|
- Mantiene piena compatibilità con le funzionalità esistenti
|
|
- Il sistema a tab permette di passare facilmente tra le due modalità
|
|
|
|
### Migrazione da convert.py
|
|
|
|
Il file originale `convert.py` può essere mantenuto per compatibilità o rimosso.
|
|
Tutte le sue funzionalità sono ora integrate nell'applicazione principale.
|