Skip to content

Jekyll / Octopress plugin to generate PlantUML diagrams

License

Notifications You must be signed in to change notification settings

kratico/jekyll-plantuml

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 

Repository files navigation

=============== jekyll-plantuml

Background

PlantUML is a component that allows to quickly write:

  • sequence diagram,
  • use case diagram,
  • class diagram,
  • activity diagram,
  • component diagram,
  • state diagram
  • object diagram

I really like the idea of writing UML diagram with plain text, and the syntax of it is very well designed, so I use PlantUML with trac and sphinx. After switching Octopress to my blog platform, I was looking for a way to integrate PlantUML within it, though I can't find one, so I wrote this very simple jekyll plugin (Octopress is based on Jekyll).

Installation

To use with Octopress, you need to put the plantuml.rb under the plugins folder, or you can use git's submodules to add jekyll-plantuml under plugins folder.

Configuration

You need to download the plantuml.jar file from http://plantuml.sourceforge.net/download.html

In your _config.yml, setup plantuml_jar to the downloaded jar file, e.g.

plantuml_jar: ../_lib/plantuml.jar
plantuml_background_color: "#f8f8f8"

The plantuml_background_color is optional, which will change the background of the generated diagram.

Usage

Just wrap the diagram text in "plantuml" block, e.g.

{% plantuml %}
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response

Alice -> Bob: Another authentication Request
Alice <-- Bob: another authentication Response
{% endplantuml %}

About

Jekyll / Octopress plugin to generate PlantUML diagrams

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published