Convertir ZARGO a PDF

Normalmente se necesita un PDF cuando un diagrama de ArgoUML debe imprimirse, enviarse, archivarse o compartirse con alguien que no tiene ArgoUML. Como un archivo .zargo es un proyecto UML y no un documento paginado, el proceso habitual consiste en abrir sus diagramas e imprimirlos o exportarlos como PDF.

Qué es el formato ZARGO

.zargo es el formato de proyecto nativo utilizado por ArgoUML, una aplicación de modelado UML de código abierto. Almacena un modelo UML y la información de sus diagramas, incluidos los diagramas de clases, casos de uso, secuencia, actividad, estados, despliegue y colaboración.

Un proyecto puede contener varios diagramas y no define una secuencia automática de páginas para un PDF. Por lo tanto, el resultado en PDF normalmente consta de una página o archivo por cada diagrama seleccionado, seguido de una combinación opcional. Conserva el archivo .zargo original, porque el PDF no preserva el modelo UML editable.

Qué es el formato PDF

PDF conserva las dimensiones de la página, la colocación del texto, las líneas vectoriales y el diseño de impresión en distintos sistemas operativos. Los destinatarios pueden verlo e imprimirlo sin instalar ArgoUML, pero PDF es principalmente un formato de presentación y no sustituye al proyecto de origen.

Cómo crear un PDF a partir de ZARGO

Imprimir desde ArgoUML

1. Instala una versión de ArgoUML compatible con el proyecto y con el entorno de ejecución de Java requerido. Abre el proyecto con File → Open Project o utiliza el comando de apertura equivalente de esa versión.
2. Selecciona el diagrama en el navegador de proyectos o el navegador del modelo de ArgoUML.
3. Utiliza File → Print o el comando de impresión disponible. Selecciona Microsoft Print to PDF en Windows, Save as PDF en macOS o Print to File con salida PDF en Linux.
4. Establece el tamaño del papel, la orientación, los márgenes, la escala y el intervalo de páginas. La orientación horizontal y un papel de mayor tamaño suelen ser adecuados para diagramas de clases, despliegue y secuencia anchos.
5. Comprueba la vista previa de impresión antes de guardar. Utiliza una escala personalizada o páginas en mosaico si reducir el diagrama hace que las etiquetas sean ilegibles.
6. Guarda un nombre de archivo descriptivo, como class-diagram.pdf. Repite el proceso para cada diagrama requerido en el entregable.

Exportar un diagrama vectorial antes de crear el PDF

Algunas versiones de ArgoUML permiten exportar gráficos de diagramas mediante un comando como File → Export Graphics o File → Export Diagram. Si SVG o PostScript están disponibles, utilízalos en lugar de un formato rasterizado. Los nombres de los menús y los formatos compatibles varían según la versión.

Abre un SVG exportado en Inkscape y selecciona File → Save a Copy, eligiendo PDF. El comando equivalente es:

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

SVG y PostScript conservan las líneas y el texto como contenido vectorial, lo que produce resultados más nítidos en distintos tamaños que PNG o GIF. Si la versión de ArgoUML solo exporta PNG, convierte esa imagen a PDF con una aplicación de gráficos o documentos; el PDF conservará la resolución original de la imagen y no se convertirá realmente en un formato basado en vectores.

Utilizar un convertidor en línea solo después de exportar

Los servicios genéricos en línea normalmente no entienden la estructura de proyecto de ArgoUML contenida en un archivo .zargo. Es posible que lo rechacen o que no produzcan un documento útil. Si ArgoUML ha exportado un SVG, un servicio confiable como CloudConvert o Convertio puede convertir ese SVG a PDF, pero comprueba el tamaño de página y las fuentes del resultado. No subas modelos confidenciales ni código fuente a menos que las condiciones de retención y privacidad del servicio sean aceptables; la impresión local o Inkscape evita esa exposición.

Combinar diagramas en un solo PDF

Crea un PDF para cada diagrama y, a continuación, combina los archivos con una aplicación de PDF de escritorio o una utilidad local como:

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

Revisa el archivo combinado para comprobar el orden de las páginas, los recortes, las fuentes que falten y la legibilidad de las etiquetas.

Limitaciones de calidad y compatibilidad

Las versiones de ArgoUML difieren en los requisitos de Java, el comportamiento de impresión y los comandos de exportación. Si el proyecto no se abre, crea una copia de seguridad y prueba el entorno de ejecución de Java compatible con esa versión de ArgoUML en lugar de modificar el archivo original.

Los diagramas muy grandes pueden dividirse entre varias páginas, recortarse en los márgenes o reducirse hasta que el texto resulte ilegible. Utiliza la vista previa de impresión, ajusta la escala y el tamaño del papel, o exporta a SVG/PostScript cuando sea importante conservar con precisión la calidad de las líneas y el texto. Las fuentes que no estén disponibles en el sistema de conversión también pueden cambiar las métricas del texto o provocar sustituciones, por lo que debes inspeccionar el PDF final antes de distribuirlo.