Notes sur l'installation locale
Diagramme de séquence
Une fois l'installation terminée, vous devriez d'abord essayer de créer quelques diagrammes de séquence. Puisque ceux-ci fonctionnent sans Graphviz, c'est le moyen le plus rapide de vérifier que l'installation a fonctionné. S'ils ne fonctionnent pas, les autres diagrammes ne fonctionneront probablement pas.
Vous devez vous assurer de tester les Diagrammes de Séquence en utilisant la ligne de commande et non dans l'outil cible que vous voulez installer (Eclipse, Word, Mediawiki...)
java -jar plantuml.jar -verbose sequenceDiagram.txt
Dans le fichier
sequenceDiagram.txt, vous pouvez avoir un test très simple
@startuml
Alice -> Bob: test
@enduml
Le drapeau
-verbose est utilisé pour générer quelques logs que vous pouvez nous envoyer, si aucune image n'est générée.
Sous Unix, vous devez avoir les librairies X11 installées (ce qui est fait par défaut). Sinon, vous aurez des HeadlessException.
Vous devrez peut-être ajouter un drapeau -Djava.awt.headless=true dans la ligne de commande.
Si cela fonctionne, mais pas dans votre outil, c'est probablement dû à un problème spécifique à l'outil :
Sur MediaWiki et Windows, vous devez définir les permissions de lecture et d'exécution sur C:\Windows\system32\cmd.exe pour le compte sous lequel l'extension de service web PHP est exécutée. PHP a besoin de ces permissions pour "bifurquer" d'autres processus
Autres diagrammes
Une fois que les diagrammes de séquence fonctionnent correctement, vous pouvez vous concentrer sur d'autres diagrammes.
Si Graphviz n'est pas installé sur votre système, vous devez d'abord l'installer.
Sous Linux, essayez de lancer la commande dot dans un shell de commande. Vous devrez peut-être finaliser l'installation en tapant dot -C.
Vous devrez peut-être définir les variablesGRAPHVIZ_DOT si vous n'avez pas choisi le répertoire d'installation par défaut de Graphviz.
Pour tester l'installation de Graphviz, vous pouvez utiliser la ligne de commande :
java -jar plantuml.jar -testdot
Vous pouvez également utiliser cette description de diagramme spéciale :
@startuml
testdot
@enduml
Encore une fois, vous devez tester en utilisant la ligne de commande et le drapeau
-verbose:
java -jar plantuml.jar -verbose classDiagram.txt
Le fichier
classDiagram.txt peut être très simple :
@startuml
A <|-- B
@enduml
Si vous avez encore des problèmes, vous pouvez nous envoyer un e-mail.