PlantUML Renderer for WordPress

Quindi stavo scrivendo una guida su come comunicano i microservizi e continuavo a pensare "Vorrei davvero poter mostrare un diagramma di sequenza senza dover esportare PNG". È stato allora che ho trovato questo plugin. È esattamente quello che dice: scrivi il codice PlantUML in uno shortcode, premi Salva e boom, viene visualizzato il diagramma. Nessun problema con i file di immagine, nessun problema di hosting. Praticamente plug-and-play.

La roba buona

La vera vittoria è quanto sia semplice generare diagrammi complessi. Ho inserito un diagramma di sequenza di base come:

[codice]
[pianta]
@startuml
Alice -> Bob: Ciao
Bob --> Alice: Ciao
@enduml
[/plantuml]
[/codice]

E ha funzionato. Il rendering avviene tramite PlantUML SaaS, quindi non è necessario installare nulla in locale. Non è nemmeno lento: si carica velocemente, anche su dispositivi mobili. L'ho usato anche per alcuni diagrammi di attività e sembravano nitidi. Se insegni la progettazione di software o documenti le API, questo ti farà risparmiare ore di disegno manuale.

Il non-così-buono

Non è perfetto però. Il plugin non ti consente di personalizzare molto l'aspetto: nessuna opzione per colori, caratteri o modifiche al layout oltre a ciò che supporta PlantUML. E poiché si basa sul loro servizio cloud, se l'API non funziona, i tuoi diagrammi svaniscono. È un piccolo rischio, ma vale comunque la pena notare. Inoltre, il plugin non ha un editor dell'interfaccia utente: devi scrivere manualmente la sintassi PlantUML. Se non lo conosci, è una curva di apprendimento. Non è l’ideale per gli scrittori non tecnici, anche se sono d’accordo con gli shortcode.

E onestamente, la mancanza di informazioni sullo sviluppatore o sulla licenza sembra lacunosa. Nessun registro delle modifiche, nessuna pagina di supporto. Solo una singola valutazione da una persona. Questa è una bandiera rossa se gestisci un sito professionale. Ma per blog personali o progetti paralleli? Probabilmente bene.

In conclusione

Se hai già dimestichezza con la sintassi PlantUML e desideri aggiungere diagrammi UML puliti al tuo sito WordPress senza problemi, questo plugin funziona. È leggero, gratuito e porta a termine il lavoro. Ma se hai bisogno di maggiore controllo o sei preoccupato per le dipendenze, cerca altrove. Per sviluppatori, educatori o blogger tecnici che odiano esportare immagini: sì, vale la pena provarlo. PlantUML Renderer for WordPress per Wordpress è una scelta solida per il caso d'uso giusto.