DocBook and plantuml

Description

Plantuml is a modeling language to create UML diagrams (use case, class, sequence, activity, component, state, ...).

Ant4docbook aims to:

  • easy convert plantuml to svg or png, using ant + plantuml.
  • easy xinclude plantuml in docbook documents.

Installation

Please install (linux debian):
$ apt-get install graphviz

Examples

docbook-plantuml.xml

<?xml version="1.0" encoding="utf-8"?>
<article xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Test xinclude plantuml</title>
  <xi:include href="diagram.plantuml"/>    
</article>
                  
diagram.plantuml

\@startuml
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response

Alice -> Bob: Another authentication Request
Alice <-- Bob: another authentication Response
\@enduml
                  
build.xml

<project name="docbook-plantuml" default="docbook-and-plantuml"> 

  <taskdef name="dbk" 
     classname="net.sourceforge.ant4docbook.taskdefs.DocbookTask" 
     classpath="PATH/TO/ant4docbook.jar"/> 

  <target name="docbook-plantuml"> 
    <dbk file="docbook-plantuml.xml" tofile="docbook-plantuml.pdf" />
  </target> 

</project>
                  

see: docbook-plantuml.pdf