Convertir ZARGO en PDF

Les utilisateurs ont généralement besoin d’un PDF lorsqu’un diagramme ArgoUML doit être imprimé, soumis, archivé ou partagé avec une personne qui ne dispose pas d’ArgoUML. Comme un fichier .zargo est un projet UML et non un document paginé, le processus habituel consiste à ouvrir ses diagrammes, puis à les imprimer ou à les exporter au format PDF.

Qu’est-ce que le format ZARGO ?

.zargo est le format de projet natif utilisé par ArgoUML, une application de modélisation UML open source. Il stocke un modèle UML et les informations de ses diagrammes, notamment les diagrammes de classes, de cas d’utilisation, de séquence, d’activités, d’états, de déploiement et de collaboration.

Un projet peut contenir plusieurs diagrammes et ne définit pas une séquence automatique de pages pour un PDF. La sortie PDF se compose donc généralement d’une page ou d’un fichier par diagramme sélectionné, avec une fusion facultative par la suite. Conservez le fichier .zargo original, car le PDF ne préserve pas le modèle UML modifiable.

Qu’est-ce que le format PDF ?

Le PDF préserve les dimensions des pages, le positionnement du texte, les lignes vectorielles et la mise en page d’impression sur différents systèmes d’exploitation. Les destinataires peuvent l’afficher et l’imprimer sans installer ArgoUML, mais le PDF est avant tout un format de présentation et ne remplace pas le projet source.

Comment créer un PDF à partir de ZARGO

Imprimer depuis ArgoUML

1. Installez une version d’ArgoUML compatible avec le projet et l’environnement d’exécution Java requis. Ouvrez le projet avec File → Open Project ou utilisez la commande d’ouverture équivalente dans cette version.
2. Sélectionnez le diagramme dans le navigateur de projet ou le navigateur de modèle d’ArgoUML.
3. Utilisez File → Print ou la commande d’impression disponible. Sélectionnez Microsoft Print to PDF sous Windows, Save as PDF sous macOS ou Print to File avec une sortie PDF sous Linux.
4. Définissez le format du papier, l’orientation, les marges, l’échelle et la plage de pages. L’orientation paysage et un papier de plus grand format conviennent généralement aux diagrammes de classes, de déploiement et de séquence larges.
5. Vérifiez l’aperçu avant impression avant d’enregistrer. Utilisez une échelle personnalisée ou des pages en mosaïque si la réduction du diagramme rend les libellés illisibles.
6. Enregistrez le fichier sous un nom descriptif tel que class-diagram.pdf. Répétez le processus pour chaque diagramme requis dans le livrable.

Exporter un diagramme vectoriel avant de créer le PDF

Certaines versions d’ArgoUML proposent l’exportation des graphiques de diagrammes au moyen d’une commande telle que File → Export Graphics ou File → Export Diagram. Si SVG ou PostScript est disponible, utilisez ce format plutôt qu’un format raster. Les noms des menus et les formats pris en charge varient selon la version.

Ouvrez un fichier SVG exporté dans Inkscape et choisissez File → Save a Copy, puis sélectionnez PDF. La commande équivalente est :

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

SVG et PostScript conservent les lignes et le texte sous forme de contenu vectoriel, ce qui produit des résultats plus nets à différentes tailles que PNG ou GIF. Si la version d’ArgoUML exporte uniquement au format PNG, convertissez cette image en PDF avec une application graphique ou bureautique ; le PDF conservera la résolution d’origine de l’image et ne deviendra pas véritablement vectoriel.

Utiliser un convertisseur en ligne uniquement après l’exportation

Les services en ligne génériques ne comprennent généralement pas la structure des projets ArgoUML contenue dans un fichier .zargo. Ils peuvent le refuser ou ne produire aucun document utile. Si ArgoUML a exporté un fichier SVG, un service réputé tel que CloudConvert ou Convertio peut convertir ce SVG en PDF, mais vérifiez le format de la page et les polices du résultat. Ne téléversez pas de modèles confidentiels ni de code source, sauf si les conditions de conservation et de confidentialité du service vous conviennent ; l’impression locale ou Inkscape évite cette exposition.

Combiner plusieurs diagrammes dans un seul PDF

Créez un PDF pour chaque diagramme, puis fusionnez les fichiers avec une application PDF de bureau ou un utilitaire local tel que :

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

Vérifiez dans le fichier fusionné l’ordre des pages, les coupures, les polices manquantes et la lisibilité des libellés.

Limites de qualité et de compatibilité

Les versions d’ArgoUML diffèrent en ce qui concerne les exigences Java, le comportement de l’impression et les commandes d’exportation. Si le projet ne s’ouvre pas, créez une copie de sauvegarde et essayez l’environnement d’exécution Java pris en charge par cette version d’ArgoUML plutôt que de modifier le fichier original.

Les diagrammes très volumineux peuvent être répartis sur plusieurs pages, coupés au niveau des marges ou réduits jusqu’à rendre le texte illisible. Utilisez l’aperçu avant impression, ajustez l’échelle et le format du papier, ou exportez au format SVG/PostScript lorsque la qualité exacte des lignes et du texte est importante. Les polices absentes du système de conversion peuvent également modifier les métriques du texte ou entraîner des substitutions ; examinez donc le PDF final avant de le distribuer.