VALLONGOL/SXXXXXXX_MarkdownConverter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
master
SXXXXXXX_MarkdownConverter/doc/BATCH_CONVERTER.md

2.9 KiB
Raw Permalink Blame History

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.