Dibujar diagramas con PlantUML

El proyecto de software libre PlantUML busca proporcionar un mecanismo para dibujar diagramas mediante un código sencillo en texto.

PlantUML utiliza la plataforma Java para su herramienta de generación de diagramas. Esto a diferencia de Mermaid facilita que la herramienta  pueda ejecutarse localmente aunque también se dispone de un servicio de PlantUML onLine.

Instalación de PlantUML

La instalación de PlantUML en sistemas MacOS y Linux es muy sencilla ya que se encuentra disponible en varios repositorios.

Por ejemplo instalar PlantUML en MacOS es muy sencillo si ya se posee la herramienta HomeBrew. Sería tan sencillo como ejecutar el siguiente comando en la Terminal de Mac:

brew install plantuml
Una vez instalada simplemente en la Terminal ejecutaríamos el comando plantuml pasando como parámetro el fichero de texto con la información de nuestro diagrama.

Ejemplo de diagrama de estado

Como vimos en el artículo sobre dibujar diagramas con Mermaid tenemos un diagrama de estado que representa los posibles estados de un ser vivo.

En PlantUML el código sería algo como:

@startuml
[*] --> Nacer
Nacer -> Crecer
Crecer -> Reproducirse
Reproducirse -> Envejecer
Envejecer -> Morir
Morir --> [*]
@enduml

El diagrama generado tiene el siguiente aspecto:

Diagrama de estados generado con PlantUML

Además PlantUML permite exportar a un formato ASCII en texto que puede resultar interesante para leer con líneas braille.

El anterior diagrama tiene el siguiente aspecto en ASCII:

,------.                                                  
|*start|
|------|
`------'
|
|
,-----. ,------. ,------------. ,---------. ,-----.
|Nacer| |Crecer| |Reproducirse| |Envejecer| |Morir|
|-----|---|------|---|------------|---|---------|--|-----|
`-----' `------' `------------' `---------' `-----'
|
,----.
|*end|
|----|
`----'

Conclusiones

En conclusión podemos indicar que PlantUML proporciona una herramienta local sencilla y rápida para generar cierto tipo de diagramas. Proporciona algunos mecanismos de personalización que la hacen interesante para usuarios ciegos que dispongan de línea braille aunque su sintaxis quizás pueda ser más engorrosa que Mermaid para algunos tipos de diagramas de ingeniería.

4 respuestas a «Dibujar diagramas con PlantUML»

    1. Hola, PlantUML se basa en un ejecutable programado en Java por lo que se puede ejecutar sin problemas en Linux, Windows y Mac. El fichero jar se puede ejecutar con el runtime de Java en todas estas plataformas

  1. Hola, muy buen artículo.
    En primer lugar, he intentado escribir en la Terminal de macOS el comando indicado, pero dice Commanc not found. Supongo que tengo que instalar primero la herramienta HomeGrell de la que hablas, pero no sé si hay que hacerlo desde la terminal, o si la puedo descargar desde App Store o desde alguna web.
    En segundo lugar, cuando ya lo haya instalado todo, ¿se encuentra en la carpeta aplicaciones o siempre tendría que abrir la terminal?
    Por último, me gustaría saber si con esta herramienta tan útil es posible hacer gráficos de barras, como por ejemplo climogramas.
    Un saludo.

    1. Buenas

      Este programa requiere tanto de HomeBrew como de un runtime de Java para ser ejecutado.
      En principio se debe ejecutar desde la Terminal aunque puedes crearte un script

Responder a ángel Cancelar la respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.