Plant UML diagram-cli

Command line interface for generating diagrams from plant uml files in a convention based way and displaying them in markdown documents

Contents

• What does it do?
• Usage
• Windows requirements
• Mac requirements
• Libraries and useful links

What does it do?

Running diagrams init creates a ./diagrams folder populated with some default folders. Running a further command of diagrams make generates any files in the ./diagrams/puml into .png files in the ./diagrams/img folder.

It also creates a README.md in the root of ./diagrams and populates it with links to the .png files so they automatically appear in your github repository. All you have to do is add a link in your front page of your github with [Link to diagrams](./diagrams/README.md).

Usage

# install the cli globally
npm install -g diagram-cli

# show usage
diagrams --help

# initialise folders and files
diagrams init

# generate diagrams
diagrams make

Windows requirements

# You need to have graphviz installed to generate diagrams
choco install javaruntime
choco install graphviz

# Add the path to your environment variables
# C:\Program Files (x86)\Graphviz2.38\bin

Mac requirements

# You need to have graphviz installed to generate diagrams
brew install graphviz

Libraries and useful links

• Should JS docs