XInclude Plantuml inside DocBook

Posted on One min read

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 into docbook documents.

Installation

$ 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