graphviz-and-plant-uml

README

Render GraphViz and PlantUML offline.

version download

Features

  • Rendering PlantUML with quick installation.
  • Support PDF exporting.
  • ZERO npm dependency.

How Does it work

  1. Your UML/Diagram string quote with PlantUML/DOT
  2. run exec file and get output
  3. SVG(XML) file

Pre Installation

  • Java is a cross-platform Virtual Machine, which is install on Mac/Linux by default.
  • Graphviz is open source graph visualization software. It has several main graph layout programs.
  • plantuml can easily create UML Diagrams from simple textual description.

We need to install these tools before rendering UML.

If your are Mac user, try with brew

brew install graphviz
brew install plantuml

If your are the other OS user, install them manually on official website or package manager(eg, yum install graphviz).

Installation for Gitbook

In your book.json

{
  "plugins": ["graphviz-and-plant-uml"],
  "pluginsConfig": {
    "graphviz-and-plant-uml": {
      "GraphvizDotFile": "/usr/local/opt/graphviz/bin/dot",
      "PlantJar": "/usr/local/Cellar/plantuml/1.2018.12/libexec/plantuml.jar"
    },
  }
}

then

# install plugin
gitbook install
# run the gitbook
gitbook serve

How to use it?

{% puml %}
@startuml
Object <|-- ArrayList
Object : equals()
ArrayList : Object[] elementData
ArrayList : size()
@enduml
{% endpuml %}

@startuml and @endpuml are ALWAYS required or the image will fail to be generated.

or

```puml
@startuml
Object <|-- ArrayList
Object : equals()
ArrayList : Object[] elementData
ArrayList : size()
@enduml
```

Plugin will pick up block body and replace it with generated base64 svg diagram.

see more at Jetbrains's Visualizing Diagrams

Plugin

Generate PlantUML with quick installation

https://github.com/miao1007/gitbook-plugin-GraphvizAndPlantUML


Latest: 1.0.4

1.0.1, 1.0.2, 1.0.3, 1.0.4,

Requirements

GitBook
1.0.4 >=3.0.0

Maintainers

Open on NPM