asciidoctor-diagram 2.0.0 → 2.1.0

data/docs/modules/ROOT/partials/generate.adoc

@@ -0,0 +1,15 @@
+== Generating a Diagram from a Terminal
+
+You can load Asciidoctor diagram in a terminal using the `-r` flag.
+
+ $ asciidoctor -r asciidoctor-diagram sample.adoc
+
+You can also use Asciidoctor diagram with other converters, such as Asciidoctor EPUB.
+Asciidoctor-epub3 is also loaded with the `-r` flag.
+
+ $ asciidoctor -r asciidoctor-diagram -r asciidoctor-epub3 -b epub3 sample.adoc
+
+Or, you can invoke Asciidoctor and the EPUB converter with the `asciidoctor-epub3` command.
+The command implicitly sets the `-r` and `-b` flags for EPUB3 output.
+
+ $ asciidoctor-epub3 -r asciidoctor-diagram sample.adoc

data/docs/modules/ROOT/partials/installation.adoc

@@ -0,0 +1,19 @@
+== Installation
+
+Asciidoctor Diagram is a RubyGem, which can be installed using the `gem` or `bundle` commands.
+
+You can install the Asciidoctor Diagram gem by typing `gem install` in the CLI.
+
+ $ gem install asciidoctor-diagram
+
+by first adding the following entry to your project's [.path]_Gemfile_.
+
+.Gemfile
+[source,ruby]
+----
+gem 'asciidoctor-diagram'
+----
+
+Then execute `bundle` in the CLI.
+
+ $ bundle

data/docs/modules/ROOT/partials/uris.adoc

@@ -0,0 +1,38 @@
+:uri-a2s: https://github.com/dhobsd/asciitosvg
+:uri-actdiag: http://blockdiag.com/en/actdiag/index.html
+: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-bytefield: https://github.com/Deep-Symmetry/bytefield-svg
+:uri-ditaa: http://ditaa.sourceforge.net/
+:uri-dpic: https://gitlab.com/aplevich/dpic
+: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
+:uri-mermaid: https://github.com/mermaid-js/mermaid-cli
+:uri-mscgen: http://www.mcternan.me.uk/mscgen/
+:uri-nomnoml: http://nomnoml.com
+:uri-nwdiag: http://blockdiag.com/en/nwdiag/index.html
+:uri-packetdiag: http://blockdiag.com/en/nwdiag/index.html
+:uri-phantomjs: http://phantomjs.org
+:uri-pikchr: https://pikchr.org
+:uri-plantuml: http://plantuml.sourceforge.net
+:uri-py-plantuml: https://code.google.com/p/asciidoc-plantuml/
+: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-symbolator: https://github.com/kevinpt/symbolator
+:uri-syntrax: https://kevinpt.github.io/syntrax/
+:uri-tikz: https://github.com/pgf-tikz/pgf
+:uri-umlet: http://www.umlet.com/
+:uri-vega: https://vega.github.io/vega/
+:uri-vegalite: https://vega.github.io/vega-lite/
+:uri-wavedrom: http://wavedrom.com
+:uri-wavedromeditor: https://github.com/wavedrom/wavedrom.github.io/releases
+:uri-wavedromcli: https://github.com/wavedrom/cli

data/examples/features.adoc

@@ -150,7 +150,7 @@ results in a block with the correct caption and id applied to it.
 Asciidoctor-diagram also supports the various diagram block in block macro form.
 These are macros of the form `<name>::<target>[<attrlist>]`.
 
-In asciidoctor-diagram the macro names are identical to the block styles: `ditaa`, `graphivz` and `plantuml`
+In asciidoctor-diagram the macro names are identical to the block styles: `ditaa`, `graphviz` and `plantuml`
 The target is the path to the file containing the diagram source code.
 When the target is a relative path it is resolved with respect to the location of the document being processed.
 The attribute list behaves mostly the same as with the block styles.

data/lib/asciidoctor-diagram.rb

@@ -1,7 +1,9 @@
 require_relative 'asciidoctor-diagram/a2s'
 require_relative 'asciidoctor-diagram/blockdiag'
 require_relative 'asciidoctor-diagram/bpmn'
+require_relative 'asciidoctor-diagram/bytefield'
 require_relative 'asciidoctor-diagram/ditaa'
+require_relative 'asciidoctor-diagram/dpic'
 require_relative 'asciidoctor-diagram/erd'
 require_relative 'asciidoctor-diagram/gnuplot'
 require_relative 'asciidoctor-diagram/graphviz'
@@ -10,11 +12,13 @@ require_relative 'asciidoctor-diagram/meme'
 require_relative 'asciidoctor-diagram/mermaid'
 require_relative 'asciidoctor-diagram/msc'
 require_relative 'asciidoctor-diagram/nomnoml'
+require_relative 'asciidoctor-diagram/pikchr'
 require_relative 'asciidoctor-diagram/plantuml'
 require_relative 'asciidoctor-diagram/salt'
 require_relative 'asciidoctor-diagram/shaape'
 require_relative 'asciidoctor-diagram/smcat'
 require_relative 'asciidoctor-diagram/svgbob'
+require_relative 'asciidoctor-diagram/symbolator'
 require_relative 'asciidoctor-diagram/syntrax'
 require_relative 'asciidoctor-diagram/tikz'
 require_relative 'asciidoctor-diagram/umlet'

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

@@ -13,13 +13,13 @@ module Asciidoctor
         [:svg]
       end
 
-      def collect_options(source, name)
+      def collect_options(source)
         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[:sx] = source.attr('scalex')
+        options[:sy] = source.attr('scaley')
+        options[:scale] = source.attr('scale')
+        options[:noblur] = source.attr('noblur') == 'true'
+        options[:font] = source.attr('fontfamily')
         options
       end
 
@@ -50,6 +50,10 @@ module Asciidoctor
           args
         end
       end
+
+      def native_scaling?
+        true
+      end
     end
   end
 end

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

@@ -19,7 +19,7 @@ module Asciidoctor
           cmd_name = self.class.const_get(:TOOL)
           alt_cmd_name = "#{cmd_name}3"
 
-          font_path = source.attr('fontpath', nil, cmd_name)
+          font_path = source.attr('fontpath')
 
           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}"]

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

@@ -15,11 +15,11 @@ module Asciidoctor
         [:png, :svg, :pdf, :jpeg]
       end
 
-      def collect_options(source, name)
+      def collect_options(source)
         options = {}
 
-        options[:width] = source.attr('width', nil, name)
-        options[:height] = source.attr('height', nil, name)
+        options[:width] = source.attr('width')
+        options[:height] = source.attr('height')
 
         options
       end
@@ -29,7 +29,7 @@ module Asciidoctor
 
         opts[:width] = options[:width]
 
-        bpmnjs = source.find_command('bpmn-js', :raise_on_error => false)
+        bpmnjs = source.find_command('bpmn-js')
         opts[:height] = options[:height]
         opts[:theme] = options[:theme]
         config = options[:config]

data/lib/asciidoctor-diagram/bytefield.rb

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

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

@@ -0,0 +1,26 @@
+require_relative '../diagram_converter'
+require_relative '../util/cli_generator'
+require_relative '../util/platform'
+
+module Asciidoctor
+  module Diagram
+    # @private
+    class BytefieldConverter
+      include DiagramConverter
+      include CliGenerator
+
+
+      def supported_formats
+        [:svg]
+      end
+
+      def convert(source, format, options)
+        bytefield_path = source.find_command('bytefield-svg')
+
+        generate_stdin(bytefield_path, format.to_s, source.to_s) do |tool_path, output_path|
+          [tool_path, "--output", Platform.native_path(output_path)]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+require_relative 'converter'
+require_relative '../diagram_processor'
+
+module Asciidoctor
+  module Diagram
+    class BytefieldBlockProcessor < DiagramBlockProcessor
+      use_converter BytefieldConverter
+    end
+
+    class BytefieldBlockMacroProcessor < DiagramBlockMacroProcessor
+      use_converter BytefieldConverter
+    end
+  end
+end

data/lib/asciidoctor-diagram/diagram_converter.rb

@@ -7,13 +7,17 @@ module Asciidoctor
         raise NotImplementedError.new
       end
 
-      def collect_options(source, name)
+      def collect_options(source)
         {}
       end
 
       def convert(source, format, options)
         raise NotImplementedError.new
       end
+
+      def native_scaling?
+        false
+      end
     end
   end
 end

data/lib/asciidoctor-diagram/diagram_processor.rb

@@ -3,7 +3,9 @@ require 'asciidoctor/extensions'
 require 'digest'
 require 'json'
 require 'fileutils'
+require 'pathname'
 require_relative 'diagram_source.rb'
+require_relative 'http/converter'
 require_relative 'version'
 require_relative 'util/java'
 require_relative 'util/gif'
@@ -66,7 +68,7 @@ module Asciidoctor
         supported_formats = converter.supported_formats
 
         begin
-          format = source.attributes.delete('format') || source.attr('format', supported_formats[0], name)
+          format = source.attributes.delete('format') || source.global_attr('format', supported_formats[0])
           format = format.to_sym if format.respond_to?(:to_sym)
 
           raise "Format undefined" unless format
@@ -78,8 +80,8 @@ module Asciidoctor
           caption = source.attributes.delete 'caption'
 
           case format
-          when :txt
-            block = create_literal_block(parent, source, converter)
+          when :txt, :atxt, :utxt
+            block = create_literal_block(parent, source, format, converter)
           else
             block = create_image_block(parent, source, format, converter)
           end
@@ -88,7 +90,7 @@ module Asciidoctor
           block.assign_caption(caption, 'figure')
           block
         rescue => e
-          case source.attr('on-error', 'log', 'diagram')
+          case source.global_attr('on-error', 'log')
           when 'abort'
             raise e
           else
@@ -142,29 +144,38 @@ module Asciidoctor
 
       def create_image_block(parent, source, format, converter)
         image_name = "#{source.image_name}.#{format}"
-        image_dir = image_output_dir(parent)
-        cache_dir = cache_dir(parent)
-        image_file = parent.normalize_system_path image_name, image_dir
-        metadata_file = parent.normalize_system_path "#{image_name}.cache", cache_dir
+
+        image_file = parent.normalize_system_path(image_name, image_output_dir(parent))
+        metadata_file = parent.normalize_system_path("#{image_name}.cache", cache_dir(source, parent))
 
         if File.exist? metadata_file
-          metadata = File.open(metadata_file, 'r') {|f| JSON.load f}
+          metadata = File.open(metadata_file, 'r') {|f| JSON.load(f, nil, :symbolize_names => true, :create_additions => false) }
         else
           metadata = {}
         end
 
         image_attributes = source.attributes
+        options = converter.collect_options(source)
 
-        if !File.exist?(image_file) || source.should_process?(image_file, metadata)
+        if !File.exist?(image_file) || source.should_process?(image_file, metadata) || options != metadata[:options]
           params = IMAGE_PARAMS[format]
 
-          options = converter.collect_options(source, name)
+          server_url = source.global_attr('server-url')
+          if server_url
+            server_type = source.global_attr('server-type')
+            converter = HttpConverter.new(server_url, server_type.to_sym, converter)
+          end
+
+          options = converter.collect_options(source)
           result = converter.convert(source, format, options)
 
           result.force_encoding(params[:encoding])
 
           metadata = source.create_image_metadata
-          metadata['width'], metadata['height'] = params[:decoder].get_image_size(result)
+          metadata[:options] = options
+
+          allow_image_optimisation = source.attr('optimise', 'true') == 'true'
+          result, metadata[:width], metadata[:height] = params[:decoder].post_process_image(result, allow_image_optimisation)
 
           FileUtils.mkdir_p(File.dirname(image_file)) unless Dir.exist?(File.dirname(image_file))
           File.open(image_file, 'wb') {|f| f.write result}
@@ -173,14 +184,8 @@ module Asciidoctor
           File.open(metadata_file, 'w') {|f| JSON.dump(metadata, f)}
         end
 
-        image_attributes['target'] = source.attr('data-uri', nil, true) ? image_file : image_name
-        if format == :svg
-          svg_type = source.attr('svg-type', nil, 'diagram')
-          image_attributes['opts'] = svg_type if svg_type && svg_type != 'static'
-        end
-
         scale = image_attributes['scale']
-        if scalematch = /(\d+(?:\.\d+))/.match(scale)
+        if !converter.native_scaling? && scalematch = /([0-9]+(?:\.[0-9]+)?)/.match(scale)
           scale_factor = scalematch[1].to_f
         else
           scale_factor = 1.0
@@ -188,33 +193,66 @@ module Asciidoctor
 
         if /html/i =~ parent.document.attributes['backend']
           image_attributes.delete('scale')
-          if metadata['width'] && !image_attributes['width']
-            image_attributes['width'] = (metadata['width'] * scale_factor).to_i
+          if metadata[:width] && !image_attributes['width']
+            image_attributes['width'] = (metadata[:width] * scale_factor).to_i
           end
-          if metadata['height'] && !image_attributes['height']
-            image_attributes['height'] = (metadata['height'] * scale_factor).to_i
+          if metadata[:height] && !image_attributes['height']
+            image_attributes['height'] = (metadata[:height] * scale_factor).to_i
           end
         end
 
-        image_attributes['alt'] ||= if title_text = image_attributes['title']
-                                      title_text
-                                    elsif target = image_attributes['target']
-                                      (File.basename(target, File.extname(target)) || '').tr '_-', ' '
-                                    else
-                                      'Diagram'
-                                    end
+        parent.document.register(:images, image_name)
+
+        node = Asciidoctor::Block.new parent, :image, :content_model => :empty, :attributes => image_attributes
 
-        image_attributes['alt'] = parent.sub_specialchars image_attributes['alt']
+        alt_text = node.attr('alt')
+        alt_text ||= if title_text = image_attributes['title']
+                       title_text
+                     elsif target = image_attributes['target']
+                       (File.basename(target, File.extname(target)) || '').tr '_-', ' '
+                     else
+                       'Diagram'
+                     end
+        alt_text = parent.sub_specialchars(alt_text)
 
-        parent.document.register(:images, image_name)
-        if (scaledwidth = image_attributes['scaledwidth'])
+        node.set_attr('alt', alt_text)
+
+        if (scaledwidth = node.attr('scaledwidth'))
           # append % to scaledwidth if ends in number (no units present)
           if DIGIT_CHAR_RANGE.include?((scaledwidth[-1] || 0).ord)
-            image_attributes['scaledwidth'] = %(#{scaledwidth}%)
+            node.set_attr('scaledwidth', %(#{scaledwidth}%))
+          end
+        end
+
+        use_absolute_path = source.attr('data-uri', nil, true)
+
+        if format == :svg
+          svg_type = source.global_attr('svg-type')
+          case svg_type
+            when nil, 'static'
+            when 'inline', 'interactive'
+              node.set_option(svg_type)
+              use_absolute_path = true
+            else
+              raise "Unsupported SVG type: #{svg_type}"
           end
         end
 
-        Asciidoctor::Block.new parent, :image, :content_model => :empty, :attributes => image_attributes
+        if use_absolute_path
+          node.set_attr('target', image_file)
+        else
+          node.set_attr('target', image_name)
+
+          if source.global_attr('autoimagesdir')
+            image_path = Pathname.new(image_file)
+            output_path = Pathname.new(parent.normalize_system_path(output_dir(parent)))
+
+            imagesdir = image_path.relative_path_from(output_path).dirname.to_s
+            node.set_attr('imagesdir', imagesdir)
+          end
+        end
+
+        node
       end
 
       def scale(size, factor)
@@ -227,34 +265,51 @@ module Asciidoctor
         end
       end
 
+      # Returns the image output directory as an absolute path
       def image_output_dir(parent)
-        document = parent.document
+        images_out_dir = parent.attr('imagesoutdir', nil, true)
 
-        images_dir = parent.attr('imagesoutdir', nil, true)
-
-        if images_dir
-          base_dir = nil
+        if images_out_dir
+          resolve_path(parent, images_out_dir)
         else
-          base_dir = parent.attr('outdir', nil, true) || doc_option(document, :to_dir)
           images_dir = parent.attr('imagesdir', nil, true)
+          output_dir = output_dir(parent)
+          resolve_path(parent, images_dir, output_dir)
         end
+      end
 
-        parent.normalize_system_path(images_dir, base_dir)
+      # Returns the cache directory as an absolute path
+      def cache_dir(source, parent)
+        cache_dir = source.global_attr('cachedir')
+        if cache_dir
+          resolve_path(parent, cache_dir)
+        else
+          output_dir = output_dir(parent)
+          resolve_path(parent, '.asciidoctor/diagram', output_dir)
+        end
       end
 
-      def cache_dir(parent)
-        document = parent.document
-        cache_dir = '.asciidoctor/diagram'
-        base_dir = parent.attr('outdir', nil, true) || doc_option(document, :to_dir)
-        parent.normalize_system_path(cache_dir, base_dir)
+      # Returns the general output directory for Asciidoctor as an absolute path
+      def output_dir(parent)
+        resolve_path(parent, parent.attr('outdir', nil, true) || doc_option(parent.document, :to_dir))
       end
 
-      def create_literal_block(parent, source, converter)
+      def resolve_path(parent, path, base_dir = nil)
+        if path.nil?
+          # Resolve the base dir itself
+          parent.document.path_resolver.system_path(base_dir)
+        else
+          # Resolve the path with respect to the base dir
+          parent.document.path_resolver.system_path(path, base_dir)
+        end
+      end
+
+      def create_literal_block(parent, source, format, converter)
         literal_attributes = source.attributes
         literal_attributes.delete('target')
 
-        options = converter.collect_options(source, name)
-        result = converter.convert(source, :txt, options)
+        options = converter.collect_options(source)
+        result = converter.convert(source, format, options)
 
         result.force_encoding(Encoding::UTF_8)
         Asciidoctor::Block.new parent, :literal, :source => result, :attributes => literal_attributes
@@ -298,7 +353,7 @@ module Asciidoctor
       include DiagramProcessor
 
       def self.inherited(subclass)
-        subclass.name_positional_attributes ['target', 'format']
+        subclass.name_positional_attributes ['format']
       end
 
       def apply_target_subs(parent, target)