Převod souboru ZARGO do PDF

PDF obvykle potřebujete, když je třeba diagram ArgoUML vytisknout, odevzdat, archivovat nebo sdílet s někým, kdo nemá ArgoUML. Protože soubor .zargo je UML projekt, nikoli stránkovaný dokument, běžný postup spočívá v otevření jeho diagramů a jejich vytištění nebo exportu do PDF.

Co je formát ZARGO

.zargo je nativní formát projektu používaný aplikací ArgoUML, open-source aplikací pro modelování UML. Ukládá UML model a informace o jeho diagramech včetně diagramů tříd, případů užití, sekvenčních, aktivit, stavů, nasazení a spolupráce.

Projekt může obsahovat několik diagramů a nedefinuje jednu automatickou posloupnost stránek pro PDF. Výstup PDF proto obvykle tvoří jedna stránka nebo jeden soubor pro každý vybraný diagram, po kterém může následovat sloučení. Ponechte si původní soubor .zargo, protože PDF nezachovává upravitelný UML model.

Co je formát PDF

PDF zachovává rozměry stránek, umístění textu, vektorové čáry a rozvržení tisku napříč operačními systémy. Příjemci jej mohou zobrazit a vytisknout bez instalace ArgoUML, ale PDF je především prezentační formát a nenahrazuje zdrojový projekt.

Jak vytvořit PDF ze ZARGO

Tisk z ArgoUML

1. Nainstalujte verzi ArgoUML kompatibilní s projektem a požadovaným Java runtime. Otevřete projekt pomocí File → Open Project nebo použijte ekvivalentní příkaz pro otevření v dané verzi.
2. Vyberte diagram v prohlížeči projektu nebo navigátoru modelu ArgoUML.
3. Použijte File → Print nebo dostupný příkaz pro tisk. V systému Windows vyberte Microsoft Print to PDF, v macOS Save as PDF nebo v Linuxu Print to File s výstupem PDF.
4. Nastavte velikost papíru, orientaci, okraje, měřítko a rozsah stránek. Orientace na šířku a větší papír obvykle vyhovují širokým diagramům tříd, nasazení a sekvenčním diagramům.
5. Před uložením zkontrolujte náhled tisku. Pokud se při zmenšení diagramu stanou popisky nečitelnými, použijte vlastní měřítko nebo rozdělení na dlaždicové stránky.
6. Uložte popisný název souboru, například class-diagram.pdf. Postup opakujte pro každý diagram požadovaný ve výstupu.

Export vektorového diagramu před vytvořením PDF

Některé verze ArgoUML umožňují export grafiky diagramu pomocí příkazu, jako je File → Export Graphics nebo File → Export Diagram. Pokud je k dispozici SVG nebo PostScript, použijte jej místo rastrového formátu. Názvy nabídek a podporované formáty se liší podle verze.

Otevřete exportovaný soubor SVG v aplikaci Inkscape a zvolte File → Save a Copy s výběrem PDF. Ekvivalentní příkaz je:

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

SVG a PostScript zachovávají čáry a text jako vektorový obsah, takže při různých velikostech poskytují ostřejší výsledek než PNG nebo GIF. Pokud verze ArgoUML exportuje pouze PNG, převeďte tento obrázek do PDF pomocí grafické nebo dokumentové aplikace; PDF zachová původní rozlišení obrázku a nestane se skutečně vektorovým.

Použijte online převodník až po exportu

Obecné online služby obvykle nerozumějí struktuře projektu ArgoUML v souboru .zargo. Mohou jej odmítnout nebo vytvořit nepoužitelný dokument. Pokud ArgoUML exportoval SVG, může renomovaná služba, například CloudConvert nebo Convertio, převést toto SVG do PDF, ale zkontrolujte výslednou velikost stránky a písma. Nenahrávejte důvěrné modely ani zdrojový kód, pokud vám nevyhovují podmínky uchovávání dat a ochrany soukromí dané služby; místní tisk nebo Inkscape tomuto riziku zabrání.

Sloučení diagramů do jednoho PDF

Vytvořte PDF pro každý diagram a poté soubory sloučte pomocí desktopové aplikace pro PDF nebo místního nástroje, například:

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

Zkontrolujte sloučený soubor, zda je správné pořadí stránek, nedochází k ořezání, nechybějí písma a popisky jsou čitelné.

Omezení kvality a kompatibility

Jednotlivé verze ArgoUML se liší požadavky na Java, chováním při tisku a příkazy pro export. Pokud se projekt neotevře, vytvořte záložní kopii a vyzkoušejte Java runtime podporovaný danou verzí ArgoUML, místo abyste upravovali původní soubor.

Velmi velké diagramy mohou být rozděleny na více stránek, oříznuty u okrajů nebo zmenšeny natolik, že text nebude čitelný. Použijte náhled tisku, upravte měřítko a velikost papíru nebo exportujte SVG/PostScript, pokud záleží na přesné kvalitě čar a textu. Písma nedostupná v systému provádějícím převod mohou také změnit metriky textu nebo způsobit jejich nahrazení, proto před distribucí zkontrolujte výsledné PDF.