/jekyll-plantuml

PlantUML plugin for Jekyll

Primary LanguageRubyMIT LicenseMIT

Gem Version

Install Jekyll plugin

Install it first:

gem install jekyll-plantuml

With Jekyll 2, simply add the gem to your _config.yml gems list:

gems: ['jekyll-plantuml', ... your other plugins]

Or for previous versions, create a plugin file within your Jekyll project's _plugins directory:

# _plugins/plantuml-plugin.rb
require "jekyll-plantuml"

Highly recommend to use Bundler. If you're using it, add this line to your Gemfile:

gem "jekyll-plantuml"

Install plantuml.jar

Then, make sure PlantUML is installed on your build machine, and can be executed with a simple plantuml command.

For Linux user, you could create a /usr/bin/plantuml with contents:

#!/bin/bash

java -jar /home/user/Downloads/plantuml.jar "$1" "$2"

Remember to change the path to plantuml.jar file.

Then set executable permission.

chmod +x /usr/bin/plantuml

Test

Now, it's time to create a diagram, in your Jekyll blog page:

{% plantuml %}
[First] - [Second]
{% endplantuml %}

Check this blog post. UML sequence diagram in this page is generated with this plugin. Blog sources are available in Github.