Konwertuj ZARGO na PDF

Użytkownicy zazwyczaj potrzebują pliku PDF, gdy diagram ArgoUML ma zostać wydrukowany, przesłany, zarchiwizowany lub udostępniony osobie, która nie ma programu ArgoUML. Ponieważ plik .zargo jest projektem UML, a nie dokumentem z podziałem na strony, standardowa procedura polega na otwarciu jego diagramów i wydrukowaniu ich lub wyeksportowaniu do formatu PDF.

Czym jest format ZARGO

.zargo to natywny format projektu używany przez ArgoUML, aplikację open source do modelowania UML. Przechowuje model UML i informacje o jego diagramach, w tym diagramy klas, przypadków użycia, sekwencji, aktywności, stanów, wdrożenia i współpracy.

Projekt może zawierać kilka diagramów i nie definiuje jednej automatycznej kolejności stron dla pliku PDF. Dane wyjściowe PDF zwykle składają się z jednej strony lub pliku dla każdego wybranego diagramu, po czym można je opcjonalnie połączyć. Zachowaj oryginalny plik .zargo, ponieważ PDF nie zachowuje edytowalnego modelu UML.

Czym jest format PDF

PDF zachowuje wymiary stron, rozmieszczenie tekstu, linie wektorowe i układ wydruku w różnych systemach operacyjnych. Odbiorcy mogą go wyświetlać i drukować bez instalowania programu ArgoUML, ale PDF jest przede wszystkim formatem prezentacyjnym i nie zastępuje projektu źródłowego.

Jak utworzyć plik PDF z pliku ZARGO

Drukowanie z ArgoUML

1. Zainstaluj wersję ArgoUML zgodną z projektem i wymaganym środowiskiem Java. Otwórz projekt za pomocą File → Open Project lub użyj odpowiedniego polecenia otwierania w danej wersji.
2. Wybierz diagram w przeglądarce projektu ArgoUML lub nawigatorze modelu.
3. Użyj polecenia File → Print lub dostępnego polecenia drukowania. W systemie Windows wybierz Microsoft Print to PDF, w systemie macOS Save as PDF, a w systemie Linux Print to File z wyjściem PDF.
4. Ustaw rozmiar papieru, orientację, marginesy, skalę i zakres stron. Orientacja pozioma oraz większy papier zwykle lepiej nadają się do szerokich diagramów klas, wdrożenia i sekwencji.
5. Przed zapisaniem sprawdź podgląd wydruku. Użyj niestandardowej skali lub drukowania na sąsiadujących stronach, jeśli pomniejszenie diagramu sprawia, że etykiety stają się nieczytelne.
6. Zapisz opisową nazwę pliku, na przykład class-diagram.pdf. Powtórz ten proces dla każdego diagramu wymaganego w dostarczanym materiale.

Eksport diagramu wektorowego przed utworzeniem pliku PDF

Niektóre wersje ArgoUML umożliwiają eksport grafiki diagramu za pomocą polecenia takiego jak File → Export Graphics lub File → Export Diagram. Jeśli dostępne są formaty SVG lub PostScript, użyj ich zamiast formatu rastrowego. Nazwy menu i obsługiwane formaty różnią się w zależności od wersji.

Otwórz wyeksportowany plik SVG w programie Inkscape i wybierz File → Save a Copy, a następnie PDF. Odpowiednie polecenie to:

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

SVG i PostScript zachowują linie oraz tekst jako zawartość wektorową, zapewniając lepszą ostrość przy różnych rozmiarach niż PNG lub GIF. Jeśli dana wersja ArgoUML eksportuje tylko do PNG, przekonwertuj ten obraz do PDF za pomocą aplikacji graficznej lub edytora dokumentów; PDF zachowa oryginalną rozdzielczość obrazu i nie stanie się rzeczywiście oparty na grafice wektorowej.

Używaj konwertera online dopiero po eksporcie

Ogólne usługi online zazwyczaj nie rozumieją struktury projektu ArgoUML zawartej w pliku .zargo. Mogą go odrzucić lub wygenerować bezużyteczny dokument. Jeśli ArgoUML wyeksportował plik SVG, renomowana usługa, taka jak CloudConvert lub Convertio, może przekonwertować ten plik SVG do PDF, ale sprawdź wynikowy rozmiar strony i czcionki. Nie przesyłaj poufnych modeli ani kodu źródłowego, chyba że warunki przechowywania danych i prywatności usługi są akceptowalne; drukowanie lokalne lub użycie programu Inkscape pozwala uniknąć takiego ujawnienia.

Łączenie diagramów w jeden plik PDF

Utwórz plik PDF dla każdego diagramu, a następnie połącz pliki za pomocą desktopowej aplikacji PDF lub lokalnego narzędzia, takiego jak:

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

Sprawdź połączony plik pod kątem kolejności stron, przycięć, brakujących czcionek i czytelności etykiet.

Ograniczenia jakości i zgodności

Poszczególne wersje ArgoUML różnią się wymaganiami dotyczącymi Java, sposobem drukowania i poleceniami eksportu. Jeśli projektu nie można otworzyć, utwórz kopię zapasową i spróbuj użyć środowiska Java obsługiwanego przez daną wersję ArgoUML, zamiast modyfikować oryginalny plik.

Bardzo duże diagramy mogą zostać podzielone na strony, przycięte przy marginesach lub pomniejszone do momentu, w którym tekst stanie się nieczytelny. Użyj podglądu wydruku, dostosuj skalę i rozmiar papieru albo wyeksportuj diagram do SVG/PostScript, gdy ważna jest dokładna jakość linii i tekstu. Czcionki niedostępne w systemie wykonującym konwersję mogą również zmienić metrykę tekstu lub spowodować podstawienie czcionek, dlatego przed rozpowszechnieniem sprawdź końcowy plik PDF.