asciidoctor-diagram 1.5.18 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8e3c8549b195285f274052e14c6addc52c5900a80fcf88935cb3820432903ac
-  data.tar.gz: b673dd81b505260bf7fd06e45ef98df1806a22684a4036fb4c4e006317384538
+  metadata.gz: d37e7e92d9ff0bcae6607a862a17d8d642a54ad482f896a671c698993c22ad18
+  data.tar.gz: 9da43fb78ccd16a79e341c662f0e6dae0fdb2edf4bd9697005f4321c8e518fe0
 SHA512:
-  metadata.gz: 193b91c7ddac87a1e0fad1a1c65b6dcb6406888c54443f5a6ae8be8f6ffb3845708e6c29a4a0d5d11438411d7281f60be1b0be79d280bf68a8764daf3a0ed4ea
-  data.tar.gz: 18e6d118480da5b4010df9bcc0fa58bd852d5cf70bb48960f55b31235bb6bfe58cfa4fe47eab3d750a56262db9f8a76c390b85cb88dffbbfd9df1f8c512d3fd5
+  metadata.gz: 5366ef0c9961283fa4df0dd1b59774237dfc78923160e705d739d856f7b8dd64dc0edd4b93bc7cc139e413481dd597a384b952e52483a36a672e3f47eed30e2f
+  data.tar.gz: b2828d5e8987b2f27f2c1c55a0bd80eae39b7c2015c09c9899cf5ad1ce0e264cef2af7782a402225ceea81027f65ef12480a8882af90e0dd4571e98fb1571c5c

data/CHANGELOG.adoc

@@ -1,5 +1,33 @@
 = Asciidoctor-diagram Changelog
 
+== 2.0.0
+
+Enhancements::
+  * Cleaned up internals of the extension
+  * Add support for BPMN (@gtudan)
+  * Update PlantUML to v1.2019.12
+  * #231 Improve PlantUML error reporting
+  * #247 Add support for document-level `diagram-svg-type` and block-level `svg-type` attributes to control SVG interactivity
+  * #250 Add support for Mermaid's `puppeteerConfig` option (@ldz-w)
+
+== 1.5.19
+
+Bug Fixes::
+  * Issue #233: Resolve character encoding issues with Ditaa on Windows with Java runtimes that do not use UTF-8 encoding by default
+  * Fix generation of SVG output for TikZ diagrams (@joelsmith)
+  * Improve TikZ image cropping (@joelsmith)  
+
+Enhancements::
+  * Issue #225: Add support for WaveDrom CLI 2.0.0
+  * Issue #234: Add support for State Machine Cat
+  * Add support for gnuplot (@MariuszCwikla)
+
+== 1.5.18
+
+Bug Fixes::
+
+  * Issue #224: Fix asciidoctor 1.5.x compatibility regression introduced in 1.5.17
+
 == 1.5.17
 
 Enhancements::

data/README.adoc

@@ -18,9 +18,11 @@ ifndef::env-site[:status:]
 :uri-asciidoctor-api: http://asciidoctor.org/docs/user-manual/#api
 :uri-asciidoctor-extensions: http://asciidoctor.org/docs/user-manual/#extension-points
 :uri-blockdiag: http://blockdiag.com
+:uri-bpmn: https://github.com/gtudan/bpmn-js-cmd
 :uri-ditaa: http://ditaa.sourceforge.net/
 :uri-dot: https://graphviz.gitlab.io/_pages/doc/info/lang.html
 :uri-erd: https://github.com/BurntSushi/erd
+:uri-gnuplot: http://gnuplot.info
 :uri-graphviz: https://graphviz.gitlab.io
 :uri-imagemagick: http://www.imagemagick.org
 :uri-java: http://java.sun.com
@@ -35,6 +37,7 @@ ifndef::env-site[:status:]
 :uri-rackdiag: http://blockdiag.com/en/nwdiag/index.html
 :uri-seqdiag: http://blockdiag.com/en/seqdiag/index.html
 :uri-shaape: https://github.com/christiangoltz/shaape
+:uri-smcat: https://github.com/sverweij/state-machine-cat
 :uri-svgbob: https://github.com/ivanceras/svgbobrus
 :uri-syntrax: https://kevinpt.github.io/syntrax/
 :uri-umlet: http://www.umlet.com/
@@ -46,7 +49,7 @@ ifndef::env-site[:status:]
 
 Asciidoctor Diagram is a set of Asciidoctor extensions that enable you to add diagrams, which you describe using plain text, to your AsciiDoc document.
 
-The extensions supports the {uri-a2s}[AsciiToSVG], BlockDiag ({uri-blockdiag}[BlockDiag], {uri-seqdiag}[SeqDiag], {uri-actdiag}[ActDiag], {uri-nwdiag}[NwDiag]), {uri-ditaa}[Ditaa], {uri-erd}[Erd], {uri-dot}[GraphViz], {uri-mermaid}[Mermaid], {uri-mscgen}[Msc], {uri-nomnoml}[Nomnoml], {uri-plantuml}[PlantUML], {uri-shaape}[Shaape], {uri-svgbob}[SvgBob], {uri-syntrax}[Syntrax], {uri-umlet}[UMLet], {uri-vega}[Vega], {uri-vegalite}[Vega-Lite] and {uri-wavedrom}[WaveDrom] syntax.
+The extensions supports the {uri-a2s}[AsciiToSVG], BlockDiag ({uri-blockdiag}[BlockDiag], {uri-seqdiag}[SeqDiag], {uri-actdiag}[ActDiag], {uri-nwdiag}[NwDiag]), {uri-ditaa}[Ditaa], {uri-erd}[Erd], {uri-gnuplot}[Gnuplot], {uri-dot}[GraphViz], {uri-mermaid}[Mermaid], {uri-mscgen}[Msc], {uri-nomnoml}[Nomnoml], {uri-plantuml}[PlantUML], {uri-shaape}[Shaape], {uri-smcat}[State Machine Cat], {uri-svgbob}[SvgBob], {uri-syntrax}[Syntrax], {uri-umlet}[UMLet], {uri-vega}[Vega], {uri-vegalite}[Vega-Lite] and {uri-wavedrom}[WaveDrom] syntax.
 
 Each extension runs the diagram processor to generate an SVG, PNG, or TXT file from the input text.
 The generated file is then inserted into your converted document.
@@ -119,8 +122,10 @@ The following diagram types and output formats are available:
 |{uri-a2s}[a2s]              |       |       |       |{check}|
 |{uri-actdiag}[actdiag]      |       |{check}|{check}|{check}|
 |{uri-blockdiag}[blockdiag]  |       |{check}|{check}|{check}|
+|{uri-bpmn}[bpmn]            |       |{check}|{check}|{check}|
 |{uri-ditaa}[ditaa]          |       |       |{check}|{check}|
 |{uri-erd}[erd]              |       |       |{check}|{check}|
+|{uri-gnuplot}[gnuplot]      |{check}|       |{check}|{check}|{check}
 |{uri-dot}[graphviz]         |       |{check}|{check}|{check}|
 |<<meme,meme>>               |{check}|       |{check}|       |
 |{uri-mermaid}[mermaid]      |       |{check}|{check}|{check}|
@@ -132,6 +137,7 @@ The following diagram types and output formats are available:
 |{uri-rackdiag}[rackdiag]    |       |{check}|{check}|{check}|
 |{uri-seqdiag}[seqdiag]      |       |{check}|{check}|{check}|
 |{uri-shaape}[shaape]        |       |       |{check}|{check}|
+|{uri-smcat}[smcat]          |       |       |       |{check}|
 |{uri-svgbob}[svgbob]        |       |       |       |{check}|
 |{uri-syntrax}[syntrax]      |       |{check}|{check}|{check}|
 |{uri-umlet}[umlet]          |{check}|{check}|{check}|{check}|
@@ -249,7 +255,7 @@ or load and register each extension individually.
 require 'asciidoctor-diagram/<extension_name>'
 ----
 
-`<extension_name>` can be one of `a2s`, `blockdiag`, `ditaa`, `erd`, `graphviz`, `meme`, `mermaid`, `msc`, `plantuml`, `shaape`, `svgbob`, `syntrax`, `umlet`, `vega` or `wavedrom`.
+`<extension_name>` can be one of `a2s`, `blockdiag`, `ditaa`, `erd`, `gnuplot`, `graphviz`, `meme`, `mermaid`, `msc`, `plantuml`, `shaape`, `smcat`, `svgbob`, `syntrax`, `umlet`, `vega` or `wavedrom`.
 
 Requiring one or more of these files will automatically register the extensions for all processed documents.
 
@@ -295,8 +301,10 @@ The following table lists the tools that are required for each diagram type, the
    |a2s          |{uri-a2s}[AsciiToSvg]                                                 |`a2s`
    |actdiag      |{uri-actdiag}[ActDiag]                                                |`actdiag`
    |blockdiag    |{uri-blockdiag}[BlockDiag]                                            |`blockdiag`
+   |bpmn         |{uri-bpmn}[bpmn-js-cmd]                                               |`bpmn`
    |ditaa        |{uri-java}[Java]                                                      |`java`
    |erd          |{uri-erd}[Erd]                                                        |`erd`
+   |gnuplot      |{uri-gnuplot}[Gnuplot]                                                |`gnuplot`
    |graphviz     |{uri-graphviz}[GraphViz]                                              |`dot` or `graphvizdot`
    |meme         |{uri-imagemagick}[ImageMagick]                                        |`convert` and `identify`
    |mermaid      |{uri-mermaid}[Mermaid.cli]                                            |`mermaid`
@@ -308,13 +316,14 @@ The following table lists the tools that are required for each diagram type, the
    |rackdiag     |{uri-nwdiag}[NwDiag]                                                  |`rackdiag`
    |seqdiag      |{uri-seqdiag}[SeqDiag]                                                |`seqdiag`
    |shaape       |{uri-shaape}[Shaape]                                                  |`shaape`
+   |smcat        |{uri-smcat}[State Machine Cat]                                        |`smcat`
    |svgbob       |{uri-svgbob}[SvgBob]                                                  |`svgbob`
    |syntrax      |{uri-syntrax}[Syntrax]                                                |`syntrax`
    |umlet        |{uri-umlet}[Umlet]                                                    |`umlet`
    |vega         |{uri-vega}[vg2png] and/or {uri-vega}[vg2png]                          |`vg2png` and `vg2svg`
    |vegalite     |{uri-vegalite}[vl2vg] and {uri-vega}[vg2png] and/or {uri-vega}[vg2svg]|`vl2vg`, `vg2png` and `vg2svg`
 .2+|wavedrom     |{uri-wavedromeditor}[WaveDrom Editor]                                 |`wavedrom`
-                 |{uri-wavedromcli}[WaveDrom CLI] and {uri-phantomjs}[PhantomJS]        |`wavedrom` and `phantomjs`
+                 |{uri-wavedromcli}[WaveDrom CLI] (and {uri-phantomjs}[PhantomJS] for WaveDrom CLI v1)      |`wavedrom` (and `phantomjs`)
 |===
 
 If for instance you installed `actdiag` in `/home/me/actdiag/bin` and this path is not included in the `PATH` you can specify its location on the command line
@@ -328,12 +337,12 @@ The meme extension provides a basic '`Advice Animal`' style image generator.
 It's usage is easiest to explain with an example.
 
 ----
-meme::yunoguy.jpg[Doc writers,Y U NO \\ AsciiDoc]
+meme::yunoguy.jpg[Doc writers,Y U NO // AsciiDoc]
 ----
 
 The target of the block macro tells the extension which image to use as background.
 The first two positional attributes are `top` and `bottom` and are used for the top and bottom label.
-Occurrences of `\\` surrounded by whitespace are interpreted as line breaks.
+Occurrences of `//` surrounded by whitespace are interpreted as line breaks.
 
 === Diagram Attributes
 
@@ -377,6 +386,15 @@ The attribute name at the block level should be prefixed with the name of the di
 |fontpath     |unspecified     |The path to the font that should be used by blockdiag
 |===
 
+==== BPMN
+
+[cols=">,<,<",options="header"]
+|===
+|Name         |Default value   |Description
+|height       |786             |The target height of the diagram. Does not apply for output type `svg`.
+|width        |1024            |The target width of the diagram. Does not apply for output type `svg`.
+|===
+
 ==== Ditaa
 
 [cols=">,<,<",options="header"]
@@ -394,6 +412,20 @@ The attribute name at the block level should be prefixed with the name of the di
 |transparent  |false           |Makes the background of the image transparent instead of using the background color.
 |===
 
+==== Gnuplot
+
+[cols=">,<,<",options="header"]
+|===
+|Name         |Default value   |Description
+|background   |unspecified     |Background color, e.g. `red`, `#FF0000`. Does not work with `txt`.
+|height       |unspecified     |The height of the plot. Must be specified together with `width`.
+|width        |unspecified     |The width of the plot. Must be specified together with `height`.
+|crop         |unspecified     |Trims blank space from the edges of the completed plot (true/false). Does not work with `svg`, `pdf`.
+|transparent  |unspecified     |Generate transparent background (true/false). Does not work with `svg`, `pdf`, `txt`. 
+|font         |unspecified     |The font face with optional font size to use for the text, e.g. `font="Arial"`, `font="Arial,11"`. Does not work with `txt`.
+|fontscale    |unspecified     |Scales all label for given factor. Does not work with `txt`.
+|===
+
 ==== GraphViz
 
 [cols=">,<,<",options="header"]
@@ -418,15 +450,16 @@ The attribute name at the block level should be prefixed with the name of the di
 
 [cols=">,<,<",options="header"]
 |===
-|Name          |Default value   |Description
-|background    |FFFFFF          |The background colour of the image. The format should be a six-digit hexadecimal number (as in HTML, FF0000 for red). Pass an eight-digit hex to define transparency.
-|css           |unspecified     |Path to a CSS file to pass to mermaid.
-|config        |unspecified     |Path to a JSON config file to pass to mermaid.
-|ganttconfig   |unspecified     |Path to a gantt config file to pass to mermaid.
-|sequenceconfig|unspecified     |Path to a sequence config file to pass to mermaid.
-|theme         |unspecified     |Theme of the chart, could be default, forest, dark or neutral.
-|width         |unspecified     |Width of the page.
-|height        |unspecified     |Height of the page.
+|Name            |Default value   |Description
+|background      |FFFFFF          |The background colour of the image. The format should be a six-digit hexadecimal number (as in HTML, FF0000 for red). Pass an eight-digit hex to define transparency.
+|css             |unspecified     |Path to a CSS file to pass to mermaid.
+|config          |unspecified     |Path to a JSON config file to pass to mermaid.
+|ganttConfig     |unspecified     |Path to a gantt config file to pass to mermaid.
+|puppeteerConfig |unspecified     |Path to a puppeteer config file to pass to mermaid.
+|sequenceConfig  |unspecified     |Path to a sequence config file to pass to mermaid.
+|theme           |unspecified     |Theme of the chart, could be default, forest, dark or neutral.
+|width           |unspecified     |Width of the page.
+|height          |unspecified     |Height of the page.
 |===
 
 ==== Msc
@@ -445,6 +478,15 @@ The attribute name at the block level should be prefixed with the name of the di
 |config        |unspecified     |Path to a config file to pass to PlantUML.
 |===
 
+==== State Machine Cat
+
+[cols=">,<,<",options="header"]
+|===
+|Name          |Default value   |Description
+|direction     |unspecifed      |The direction of the state machine diagram. One of `top-down`, `bottom-top`, `left-right` or `right-left`.
+|engine        |unspecified     |The layout engine to use. One of `dot`, `circo`, `fdp`, `neato`, `osage`, or `twopi`
+|===
+
 ==== Syntrax
 
 [cols=">,<,<",options="header"]

data/examples/features.adoc

@@ -160,5 +160,5 @@ Instead the name of the generated image is derived from the target propery of th
 The previous example in block macro form would look something like this with the text from the block located in a file called `activity_diagram.txt` instead of inline in the document.
 
 ----
-plantuml:activity_diagram.txt[format="svg", align="center"]
-----
+plantuml::activity_diagram.txt[format="svg", align="center"]
+----

data/lib/asciidoctor-diagram/a2s/converter.rb

@@ -0,0 +1,55 @@
+require_relative '../diagram_converter'
+require_relative '../util/cli_generator'
+require_relative '../util/platform'
+
+module Asciidoctor
+  module Diagram
+    # @private
+    class AsciiToSvgConverter
+      include DiagramConverter
+      include CliGenerator
+
+      def supported_formats
+        [:svg]
+      end
+
+      def collect_options(source, name)
+        options = {}
+        options[:sx] = source.attr('scalex', nil, name)
+        options[:sy] = source.attr('scaley', nil, name)
+        options[:scale] = source.attr('scale', nil, name)
+        options[:noblur] = source.attr('noblur', nil, name) == 'true'
+        options[:font] = source.attr('fontfamily', nil, name)
+        options
+      end
+
+      def convert(source, format, options)
+        sx = options[:sx]
+        sy = options[:sy]
+        scale = options[:scale]
+        noblur = options[:noblur]
+        font = options[:font]
+
+        generate_stdin(source.find_command('a2s'), format.to_s, source.to_s) do |tool_path, output_path|
+          args = [tool_path, '-o', Platform.native_path(output_path)]
+
+          if sx && sy
+            args << '-s' << "#{sx},#{sy}"
+          elsif scale
+            args << '-s' << "#{scale},#{scale}"
+          end
+
+          if noblur
+            args << '-b'
+          end
+
+          if font
+            args << '-f' << font
+          end
+
+          args
+        end
+      end
+    end
+  end
+end

data/lib/asciidoctor-diagram/a2s/extension.rb

@@ -1,60 +1,14 @@
-require_relative '../extensions'
-require_relative '../util/cli_generator'
-require_relative '../util/platform'
-require_relative '../util/which'
+require_relative 'converter'
+require_relative '../diagram_processor'
 
 module Asciidoctor
   module Diagram
-    # @private
-    module AsciiToSvg
-      include CliGenerator
-      include Which
-
-      def self.included(mod)
-        [:svg].each do |f|
-          mod.register_format(f, :image) do |parent, source|
-            a2s(parent, source, f)
-          end
-        end
-      end
-
-      def a2s(parent, source, format)
-        inherit_prefix = name
-
-        sx = source.attr('scalex', nil, inherit_prefix)
-        sy = source.attr('scaley', nil, inherit_prefix)
-        scale = source.attr('scale', nil, inherit_prefix)
-        noblur = source.attr('noblur', 'false', inherit_prefix) == 'true'
-        font = source.attr('fontfamily', nil, inherit_prefix)
-
-        generate_stdin(which(parent, 'a2s'), format.to_s, source.to_s) do |tool_path, output_path|
-          args = [tool_path, '-o', Platform.native_path(output_path)]
-
-          if sx && sy
-            args << '-s' << "#{sx},#{sy}"
-          elsif scale
-            args << '-s' << "#{scale},#{scale}"
-          end
-
-          if noblur
-            args << '-b'
-          end
-
-          if font
-            args << '-f' << font
-          end
-
-          args
-        end
-      end
-    end
-
-    class AsciiToSvgBlockProcessor < Extensions::DiagramBlockProcessor
-      include AsciiToSvg
+    class AsciiToSvgBlockProcessor < DiagramBlockProcessor
+      use_converter AsciiToSvgConverter
     end
 
-    class AsciiToSvgBlockMacroProcessor < Extensions::DiagramBlockMacroProcessor
-      include AsciiToSvg
+    class AsciiToSvgBlockMacroProcessor < DiagramBlockMacroProcessor
+      use_converter AsciiToSvgConverter
     end
   end
 end

data/lib/asciidoctor-diagram/blockdiag/converter.rb

@@ -0,0 +1,37 @@
+require_relative '../diagram_converter'
+require_relative '../util/cli_generator'
+require_relative '../util/platform'
+
+module Asciidoctor
+  module Diagram
+    ['BlockDiag', 'SeqDiag', 'ActDiag', 'NwDiag', 'RackDiag', 'PacketDiag'].each do |name|
+      converter = Class.new do
+        include DiagramConverter
+        include CliGenerator
+
+        def supported_formats
+          [:png, :pdf, :svg]
+        end
+
+        def convert(source, format, options)
+          # On Debian based systems the Python 3.x packages python3-(act|block|nw|seq)diag executables with
+          # a '3' suffix.
+          cmd_name = self.class.const_get(:TOOL)
+          alt_cmd_name = "#{cmd_name}3"
+
+          font_path = source.attr('fontpath', nil, cmd_name)
+
+          generate_stdin(source.find_command(cmd_name, :alt_cmds => [alt_cmd_name]), format.to_s, source.to_s) do |tool_path, output_path|
+            args = [tool_path, '-a', '-o', Platform.native_path(output_path), "-T#{format.to_s}"]
+            args << "-f#{Platform.native_path(font_path)}" if font_path
+            args << '-'
+            args
+          end
+        end
+      end
+      converter.const_set(:TOOL, name.downcase)
+
+      ::Asciidoctor::Diagram.const_set("#{name}Converter", converter)
+    end
+  end
+end

data/lib/asciidoctor-diagram/blockdiag/extension.rb

@@ -1,125 +1,18 @@
-require_relative '../extensions'
-require_relative '../util/cli_generator'
-require_relative '../util/platform'
-require_relative '../util/which'
+require_relative '../diagram_processor'
+require_relative 'converter'
 
 module Asciidoctor
   module Diagram
-    # @!parse
-    #   # Block processor converts blockdiag code into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class BlockDiagBlockProcessor < API::DiagramBlockProcessor; end
-    #
-    #   # Block macro processor converts blockdiag source files into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class BlockDiagBlockMacroProcessor < DiagramBlockMacroProcessor; end
-
-    # @!parse
-    #   # Block processor converts seqdiag code into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class SeqDiagBlockProcessor < API::DiagramBlockProcessor; end
-    #
-    #   # Block macro processor converts seqdiag source files into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class SeqDiagBlockMacroProcessor < API::DiagramBlockMacroProcessor; end
-
-    # @!parse
-    #   # Block processor converts actdiag code into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class ActDiagBlockProcessor < API::DiagramBlockProcessor; end
-    #
-    #   # Block macro processor converts actdiag source files into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class ActDiagBlockMacroProcessor < API::DiagramBlockMacroProcessor; end
-
-    # @!parse
-    #   # Block processor converts nwdiag code into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class NwDiagBlockProcessor < API::DiagramBlockProcessor; end
-    #
-    #   # Block macro processor converts nwdiag source files into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class NwDiagBlockMacroProcessor < API::DiagramBlockMacroProcessor; end
-
-    # @!parse
-    #   # Block processor converts rackdiag code into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class RackDiagBlockProcessor < API::DiagramBlockProcessor; end
-    #
-    #   # Block macro processor converts rackdiag source files into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class RackDiagBlockMacroProcessor < API::DiagramBlockMacroProcessor; end
-
-    # @!parse
-    #   # Block processor converts packetdiag code into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class PacketDiagBlockProcessor < API::DiagramBlockProcessor; end
-    #
-    #   # Block macro processor converts packetdiag source files into images.
-    #   #
-    #   # Supports PNG and SVG output.
-    #   class PacketDiagBlockMacroProcessor < API::DiagramBlockMacroProcessor; end
-
-    # @private
-    module BlockDiag
-      def self.define_processors(name)
-        init = Proc.new do
-          include ::Asciidoctor::Diagram::BlockDiag
-
-          [:png, :pdf, :svg].each do |f|
-            register_format(f, :image) do |p, c|
-              blockdiag(name, p, c, f)
-            end
-          end
-        end
-
-        block = Class.new(Extensions::DiagramBlockProcessor) do
-          self.instance_eval(&init)
-        end
-        ::Asciidoctor::Diagram.const_set("#{name}BlockProcessor", block)
-
-        block_macro = Class.new(Extensions::DiagramBlockMacroProcessor) do
-          self.instance_eval(&init)
-        end
-
-        ::Asciidoctor::Diagram.const_set("#{name}BlockMacroProcessor", block_macro)
+    ['BlockDiag', 'SeqDiag', 'ActDiag', 'NwDiag', 'RackDiag', 'PacketDiag'].each do |tool|
+      block = Class.new(DiagramBlockProcessor) do
+        use_converter ::Asciidoctor::Diagram.const_get("#{tool}Converter")
       end
+      ::Asciidoctor::Diagram.const_set("#{tool}BlockProcessor", block)
 
-      include CliGenerator
-      include Which
-
-      def blockdiag(tool, parent, source, format)
-        inherit_prefix = name
-        cmd_name = tool.downcase
-
-        # On Debian based systems the Python 3.x packages python3-(act|block|nw|seq)diag executables with
-        # a '3' suffix.
-        alt_cmd_name = "#{tool.downcase}3"
-
-        font_path = source.attr('fontpath', nil, inherit_prefix)
-
-        generate_stdin(which(parent, cmd_name, :alt_cmds => [alt_cmd_name]), format.to_s, source.to_s) do |tool_path, output_path|
-          args = [tool_path, '-a', '-o', Platform.native_path(output_path), "-T#{format.to_s}"]
-          args << "-f#{Platform.native_path(font_path)}" if font_path
-          args << '-'
-          args
-        end
+      block_macro = Class.new(DiagramBlockMacroProcessor) do
+        use_converter ::Asciidoctor::Diagram.const_get("#{tool}Converter")
       end
-    end
-
-    ['BlockDiag', 'SeqDiag', 'ActDiag', 'NwDiag', 'RackDiag', 'PacketDiag'].each do |tool|
-      BlockDiag.define_processors(tool)
+      ::Asciidoctor::Diagram.const_set("#{tool}BlockMacroProcessor", block_macro)
     end
   end
 end

data/lib/asciidoctor-diagram/bpmn/converter.rb

@@ -0,0 +1,62 @@
+require_relative '../diagram_converter'
+require_relative '../util/cli'
+require_relative '../util/cli_generator'
+require_relative '../util/platform'
+
+module Asciidoctor
+  module Diagram
+    # @private
+    class BpmnConverter
+      include DiagramConverter
+      include CliGenerator
+
+
+      def supported_formats
+        [:png, :svg, :pdf, :jpeg]
+      end
+
+      def collect_options(source, name)
+        options = {}
+
+        options[:width] = source.attr('width', nil, name)
+        options[:height] = source.attr('height', nil, name)
+
+        options
+      end
+
+      def convert(source, format, options)
+        opts = {}
+
+        opts[:width] = options[:width]
+
+        bpmnjs = source.find_command('bpmn-js', :raise_on_error => false)
+        opts[:height] = options[:height]
+        opts[:theme] = options[:theme]
+        config = options[:config]
+        if config
+          opts[:config] = source.resolve_path(config)
+        end
+        run_bpmnjs(bpmnjs, source, format, opts)
+      end
+
+      private
+
+      def run_bpmnjs(bpmnjs, source, format, options = {})
+        generate_file(bpmnjs, 'bpmn', format.to_s, source.to_s) do |tool_path, input_path, output_path|
+          args = [tool_path, Platform.native_path(input_path), '-o', Platform.native_path(output_path), '-t', format.to_s]
+
+
+          if options[:width]
+            args << '--width' << options[:width]
+          end
+
+          if options[:height]
+            args << '--height' << options[:height]
+          end
+
+          args
+        end
+      end
+    end
+  end
+end

data/lib/asciidoctor-diagram/bpmn/extension.rb

@@ -0,0 +1,14 @@
+require_relative 'converter'
+require_relative '../diagram_processor'
+
+module Asciidoctor
+  module Diagram
+    class BpmnBlockProcessor < DiagramBlockProcessor
+      use_converter BpmnConverter
+    end
+
+    class BpmnBlockMacroProcessor < DiagramBlockMacroProcessor
+      use_converter BpmnConverter
+    end
+  end
+end

data/lib/asciidoctor-diagram/bpmn.rb

@@ -0,0 +1,7 @@
+require 'asciidoctor/extensions'
+require_relative 'bpmn/extension'
+
+Asciidoctor::Extensions.register do
+  block Asciidoctor::Diagram::BpmnBlockProcessor, :bpmn
+  block_macro Asciidoctor::Diagram::BpmnBlockMacroProcessor, :bpmn
+end

data/lib/asciidoctor-diagram/diagram_converter.rb

@@ -0,0 +1,19 @@
+module Asciidoctor
+  module Diagram
+    # This module describes the duck-typed interface that diagram converters must implement. Implementations
+    # may include this module but it is not required.
+    module DiagramConverter
+      def supported_formats
+        raise NotImplementedError.new
+      end
+
+      def collect_options(source, name)
+        {}
+      end
+
+      def convert(source, format, options)
+        raise NotImplementedError.new
+      end
+    end
+  end
+end