Converti ZARGO in PDF

In genere è necessario un PDF quando un diagramma ArgoUML deve essere stampato, consegnato, archiviato o condiviso con qualcuno che non dispone di ArgoUML. Poiché un file .zargo è un progetto UML e non un documento impaginato, la procedura normale consiste nell'aprire i relativi diagrammi e stamparli o esportarli come PDF.

Che cos'è il formato ZARGO

.zargo è il formato di progetto nativo utilizzato da ArgoUML, un'applicazione open-source per la modellazione UML. Memorizza un modello UML e le relative informazioni sui diagrammi, inclusi diagrammi delle classi, dei casi d'uso, di sequenza, di attività, degli stati, di deployment e di collaborazione.

Un progetto può contenere diversi diagrammi e non definisce una sequenza automatica di pagine per un PDF. L'output PDF consiste quindi normalmente in una pagina o in un file per ogni diagramma selezionato, con un'eventuale unione successiva. Conservare il file .zargo originale, perché il PDF non mantiene il modello UML modificabile.

Che cos'è il formato PDF

Il PDF preserva le dimensioni della pagina, il posizionamento del testo, le linee vettoriali e l'impaginazione di stampa tra diversi sistemi operativi. I destinatari possono visualizzarlo e stamparlo senza installare ArgoUML, ma il PDF è principalmente un formato di presentazione e non sostituisce il progetto sorgente.

Come creare un PDF da ZARGO

Stampare da ArgoUML

1. Installare una versione di ArgoUML compatibile con il progetto e con il runtime Java richiesto. Aprire il progetto con File → Open Project oppure utilizzare il comando di apertura equivalente in quella versione.
2. Selezionare il diagramma nel browser del progetto o nel navigatore del modello di ArgoUML.
3. Utilizzare File → Print oppure il comando di stampa disponibile. Selezionare Microsoft Print to PDF su Windows, Save as PDF in macOS oppure Print to File con output PDF su Linux.
4. Impostare il formato della carta, l'orientamento, i margini, la scala e l'intervallo di pagine. L'orientamento orizzontale e un formato di carta più grande sono generalmente adatti ai diagrammi delle classi, di deployment e di sequenza più ampi.
5. Controllare l'anteprima di stampa prima del salvataggio. Utilizzare una scala personalizzata o pagine affiancate se la riduzione del diagramma rende il testo illeggibile.
6. Salvare un nome file descrittivo, ad esempio class-diagram.pdf. Ripetere la procedura per ogni diagramma richiesto nel documento finale.

Esportare un diagramma vettoriale prima di creare il PDF

Alcune versioni di ArgoUML consentono di esportare la grafica del diagramma tramite un comando come File → Export Graphics o File → Export Diagram. Se è disponibile SVG o PostScript, utilizzarlo al posto di un formato raster. I nomi dei menu e i formati supportati variano in base alla versione.

Aprire un SVG esportato in Inkscape e scegliere File → Save a Copy, selezionando PDF. Il comando equivalente è:

inkscape diagram.svg --export-type=pdf --export-filename=diagram.pdf

SVG e PostScript conservano linee e testo come contenuto vettoriale, producendo risultati più nitidi a dimensioni diverse rispetto a PNG o GIF. Se la versione di ArgoUML esporta solo PNG, convertire quell'immagine in PDF con un'applicazione grafica o per documenti; il PDF manterrà la risoluzione originale dell'immagine e non diventerà realmente vettoriale.

Utilizzare un convertitore online solo dopo l'esportazione

I servizi online generici normalmente non comprendono la struttura del progetto ArgoUML contenuta in un file .zargo. Potrebbero rifiutarlo o produrre un documento inutilizzabile. Se ArgoUML ha esportato un SVG, un servizio affidabile come CloudConvert o Convertio può convertire tale SVG in PDF, ma è necessario controllare le dimensioni della pagina e i caratteri. Non caricare modelli riservati o codice sorgente a meno che i termini di conservazione e privacy del servizio non siano accettabili; la stampa locale o Inkscape evita tale esposizione.

Combinare i diagrammi in un unico PDF

Creare un PDF per ogni diagramma, quindi unire i file con un'applicazione desktop per PDF o con un'utilità locale come:

pdfunite class.pdf sequence.pdf use-case.pdf project-diagrams.pdf

Controllare il file unito verificando l'ordine delle pagine, i tagli, i caratteri mancanti e la leggibilità delle etichette.

Limiti di qualità e compatibilità

Le versioni di ArgoUML differiscono per requisiti Java, comportamento di stampa e comandi di esportazione. Se il progetto non si apre, creare una copia di backup e provare il runtime Java supportato da quella versione di ArgoUML invece di modificare il file originale.

I diagrammi molto grandi possono essere suddivisi su più pagine, tagliati ai margini o ridotti fino a rendere il testo illeggibile. Utilizzare l'anteprima di stampa, regolare la scala e il formato della carta oppure esportare in SVG/PostScript quando sono importanti la precisione delle linee e la qualità del testo. I caratteri non disponibili sul sistema di conversione possono inoltre modificare le metriche del testo o causare sostituzioni; pertanto, controllare il PDF finale prima di distribuirlo.