reverse_adoc 0.2.7 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f60fbebeee21569fdf9af0bb7153a06ac7f3a8d3431d143750e96185c701c7e
-  data.tar.gz: 72f47514bce560d201ac2b22c6b6034a02550f2e50f76200e96fa003628756f5
+  metadata.gz: eb34effa1c1af2e72ef8df7b6b1553c7c2574bcca9608e02cfaf561ed8a2bfec
+  data.tar.gz: e18b3b9cf2d936a48fdf2e6d5f265aa5c945c9493bd232a4d8fb311df780e81f
 SHA512:
-  metadata.gz: 82babe7f90eb4445d2d2bebb16dcf5a1af869da69ac5fc4da0d14e24d456a00d80f390097b10b597dbc8ec69bf782dd04d1464ef0a73cd513b4f164267ca67e1
-  data.tar.gz: 38b3887266e6c666b117d85d8df810b8e3d168b1a03af71c06fcd1218a3b99af0228686896248074767a207b32bdc6e7d16a8826ba1b11680b4371648f956576
+  metadata.gz: ca8454b96ad3064c16018f09198f8450f9a15e6525c1df6e63b7a0e3dd3254f66f2bee56e69e8c7088087962911480513f3608c759f955489b2e602dc2251890
+  data.tar.gz: 49c2198645f22b9ac26ea78aa36e1073a27807dca8364ad076250dccfc6b307055775894962d70d6400d7c8ec6b3dfa02cb31c84c922c60d8c18cbbf5ee55171

data/.github/workflows/macos.yml

@@ -1,14 +1,18 @@
-# Auto-generated !!! Do not edit it manually
-# use ci-master https://github.com/metanorma/metanorma-build-scripts
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
 name: macos
 
-on: [push]
+on:
+  push:
+    branches: [ master ]
+  pull_request:
 
 jobs:
   test-macos:
     name: Test on Ruby ${{ matrix.ruby }} macOS
     runs-on: macos-latest
     strategy:
+      fail-fast: false
       matrix:
         ruby: [ '2.6', '2.5', '2.4' ]
     steps:
@@ -20,7 +24,7 @@ jobs:
           architecture: 'x64'
       - name: Update gems
         run: |
-          sudo gem install bundler -v "~> 2" --force
+          sudo gem install bundler --force
           bundle install --jobs 4 --retry 3
       - name: Run specs
         run: |

data/.github/workflows/ubuntu.yml

@@ -1,14 +1,18 @@
-# Auto-generated !!! Do not edit it manually
-# use ci-master https://github.com/metanorma/metanorma-build-scripts
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
 name: ubuntu
 
-on: [push]
+on:
+  push:
+    branches: [ master ]
+  pull_request:
 
 jobs:
   test-linux:
     name: Test on Ruby ${{ matrix.ruby }} Ubuntu
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
         ruby: [ '2.6', '2.5', '2.4' ]
     steps:
@@ -18,9 +22,11 @@ jobs:
         with:
           ruby-version: ${{ matrix.ruby }}
           architecture: 'x64'
+      - name: Install LibreOffice
+        run: sudo apt-get -y --no-install-recommends install libreoffice
       - name: Update gems
         run: |
-          gem install bundler -v "~> 2"
+          gem install bundler
           bundle install --jobs 4 --retry 3
       - name: Run specs
         run: |

data/.github/workflows/windows.yml

@@ -1,14 +1,18 @@
-# Auto-generated !!! Do not edit it manually
-# use ci-master https://github.com/metanorma/metanorma-build-scripts
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
 name: windows
 
-on: [push]
+on:
+  push:
+    branches: [ master ]
+  pull_request:
 
 jobs:
   test-windows:
     name: Test on Ruby ${{ matrix.ruby }} Windows
     runs-on: windows-latest
     strategy:
+      fail-fast: false
       matrix:
         ruby: [ '2.6', '2.5', '2.4' ]
     steps:
@@ -18,12 +22,15 @@ jobs:
         with:
           ruby-version: ${{ matrix.ruby }}
           architecture: 'x64'
+      - name: Install LibreOffice
+        run: |
+          choco install libreoffice-still
+          echo "::add-path::C:\Program Files\LibreOffice\program"
       - name: Update gems
         shell: pwsh
         run: |
-          gem install bundler -v "~> 2"
+          gem install bundler
           bundle config --local path vendor/bundle
-          bundle update
           bundle install --jobs 4 --retry 3
       - name: Run specs
         run: |

data/Gemfile

@@ -1,5 +1,5 @@
 source "https://rubygems.org"
-  
+
 git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in reverse_asciidoctor.gemspec

data/Gemfile.lock

@@ -0,0 +1,84 @@
+PATH
+  remote: .
+  specs:
+    reverse_adoc (0.2.8)
+      mathml2asciimath
+      mimemagic
+      nokogiri (>= 1.10.4)
+      word-to-markdown
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    byebug (11.1.1)
+    cliver (0.3.2)
+    codeclimate-test-reporter (1.0.7)
+      simplecov
+    css_parser (1.7.1)
+      addressable
+    descriptive_statistics (2.5.1)
+    diff-lcs (1.3)
+    docile (1.3.2)
+    ffi (1.13.1)
+    htmlentities (4.3.4)
+    mathml2asciimath (0.0.10)
+      htmlentities (~> 4.3.4)
+      nokogiri (>= 1.10.4)
+    mimemagic (0.3.5)
+    mini_portile2 (2.4.0)
+    nokogiri (1.10.9)
+      mini_portile2 (~> 2.4.0)
+    nokogiri-styles (0.1.2)
+      nokogiri
+    premailer (1.11.1)
+      addressable
+      css_parser (>= 1.6.0)
+      htmlentities (>= 4.0.0)
+    public_suffix (4.0.5)
+    rake (13.0.1)
+    redcarpet (3.5.0)
+    reverse_markdown (1.4.0)
+      nokogiri
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.1)
+      rspec-support (~> 3.9.1)
+    rspec-expectations (3.9.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.2)
+    simplecov (0.18.5)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+    simplecov-html (0.12.1)
+    sys-proctable (1.2.5)
+      ffi
+    word-to-markdown (1.1.8)
+      cliver (~> 0.3)
+      descriptive_statistics (~> 2.5)
+      nokogiri-styles (~> 0.1)
+      premailer (~> 1.8)
+      reverse_markdown (~> 1.0)
+      sys-proctable (~> 1.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  byebug
+  codeclimate-test-reporter
+  rake
+  redcarpet
+  reverse_adoc!
+  rspec
+  simplecov
+
+BUNDLED WITH
+   2.0.2

data/README.adoc

@@ -44,10 +44,21 @@ $ reverse_adoc file.html > file.adoc
 $ cat file.html | reverse_adoc > file.adoc
 ----
 
+=== XML smrl description to AsciiDoc: `reverse_adoc`
+
+Convert XML smrl description files to AsciiDoc:
+
+[source,console]
+----
+$ reverse_adoc -f smrl_description descriptions.xml > file.adoc
+$ cat descriptions.xml | reverse_adoc -f smrl_description > file.adoc
+----
+
 [source,console]
 ----
 $ reverse_adoc -h
 Usage: reverse_adoc [options] <file>
+    -f, --input_format               Supply input format to choose converter(html or smrl_description)
     -m, --mathml2asciimath           Convert MathML to AsciiMath
     -o, --output=FILENAME            Output file to write to
     -e, --external-images            Export images if data URI

data/bin/reverse_adoc

@@ -4,7 +4,7 @@
 require 'rubygems'
 require 'bundler/setup'
 
-require 'reverse_adoc'
+require 'reverse_asciidoctor'
 require 'optparse'
 require 'fileutils'
 
@@ -23,6 +23,10 @@ OptionParser.new do |opts|
     ReverseAsciidoctor.config.external_images = true
   end
 
+  opts.on('-f', '--input_format [html, smrl_description]', 'Unknown input format (default: html)') do |v|
+    ReverseAsciidoctor.config.input_format = v
+  end
+
   opts.on('-u', '--unknown_tags [pass_through, drop, bypass, raise]', 'Unknown tag handling (default: pass_through)') do |v|
     ReverseAsciidoctor.config.unknown_tags = v
   end

data/bin/w2a

@@ -1,5 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
+
 require 'rubygems'
 require 'bundler/setup'
 
@@ -50,10 +51,9 @@ if ReverseAsciidoctor.config.external_images && ReverseAsciidoctor.config.destin
 end
 
 ReverseAsciidoctor.config.sourcedir = Dir.mktmpdir
-# puts "ReverseAsciidoctor.config.sourcedir #{ReverseAsciidoctor.config.sourcedir}"
 
 doc = WordToMarkdown.new(filename, ReverseAsciidoctor.config.sourcedir)
-File.open("test.html", "w:UTF-8") { |f| f.write doc.document.html }
+#File.open("test.html", "w:UTF-8") { |f| f.write doc.document.html }
 adoc_content = ReverseAsciidoctor.convert(
   ReverseAsciidoctor.cleaner.preprocess_word_html(doc.document.html),
   WordToMarkdown::REVERSE_MARKDOWN_OPTIONS

data/lib/reverse_asciidoctor.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'digest'
 require 'nokogiri'
 require 'reverse_asciidoctor/version'
@@ -6,55 +8,14 @@ require 'reverse_asciidoctor/cleaner'
 require 'reverse_asciidoctor/config'
 require 'reverse_asciidoctor/converters'
 require 'reverse_asciidoctor/converters/base'
-require 'reverse_asciidoctor/converters/a'
-require 'reverse_asciidoctor/converters/aside'
-require 'reverse_asciidoctor/converters/audio'
-require 'reverse_asciidoctor/converters/blockquote'
-require 'reverse_asciidoctor/converters/br'
-require 'reverse_asciidoctor/converters/bypass'
-require 'reverse_asciidoctor/converters/code'
-require 'reverse_asciidoctor/converters/div'
-require 'reverse_asciidoctor/converters/drop'
-require 'reverse_asciidoctor/converters/em'
-require 'reverse_asciidoctor/converters/figure'
-require 'reverse_asciidoctor/converters/h'
-require 'reverse_asciidoctor/converters/head'
-require 'reverse_asciidoctor/converters/hr'
-require 'reverse_asciidoctor/converters/ignore'
-require 'reverse_asciidoctor/converters/img'
-require 'reverse_asciidoctor/converters/mark'
-require 'reverse_asciidoctor/converters/li'
-require 'reverse_asciidoctor/converters/ol'
-require 'reverse_asciidoctor/converters/p'
-require 'reverse_asciidoctor/converters/pass_through'
-require 'reverse_asciidoctor/converters/pre'
-require 'reverse_asciidoctor/converters/q'
-require 'reverse_asciidoctor/converters/strong'
-require 'reverse_asciidoctor/converters/sup'
-require 'reverse_asciidoctor/converters/sub'
-require 'reverse_asciidoctor/converters/table'
-require 'reverse_asciidoctor/converters/td'
-require 'reverse_asciidoctor/converters/th'
-require 'reverse_asciidoctor/converters/text'
-require 'reverse_asciidoctor/converters/tr'
-require 'reverse_asciidoctor/converters/video'
-require 'reverse_asciidoctor/converters/math'
 
 module ReverseAsciidoctor
-
   def self.convert(input, options = {})
-    root = case input
-      when String                  then Nokogiri::HTML(input).root
-      when Nokogiri::XML::Document then input.root
-      when Nokogiri::XML::Node     then input
-    end
-
-    root or return ''
-
-    config.with(options) do
-      result = ReverseAsciidoctor::Converters.lookup(root.name).convert(root)
-      cleaner.tidy(result)
-    end
+    type = config.input_format
+    name = "#{type}_converter"
+    require "reverse_asciidoctor/#{type}_converter"
+    constant = name.split('_').map(&:capitalize).join.to_s
+    ReverseAsciidoctor.const_get(constant).convert(input, options)
   end
 
   def self.config
@@ -66,5 +27,4 @@ module ReverseAsciidoctor
   def self.cleaner
     @cleaner ||= Cleaner.new
   end
-
 end

data/lib/reverse_asciidoctor/config.rb

@@ -3,10 +3,11 @@ require 'tmpdir'
 module ReverseAsciidoctor
   class Config
     attr_accessor :unknown_tags, :tag_border, :mathml2asciimath, :external_images,
-      :destination, :sourcedir, :image_counter, :image_counter_pattern
+      :destination, :sourcedir, :image_counter, :image_counter_pattern, :input_format
 
     def initialize
       @unknown_tags     = :pass_through
+      @input_format     = :html
       @mathml2asciimath = false
       @external_images  = false
 

data/lib/reverse_asciidoctor/converters/example.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module ReverseAsciidoctor
+  module Converters
+    class Example < Base
+      def convert(node, state = {})
+        <<~TEMPLATE
+          [example]
+          ====
+          #{treat_children(node, state)}
+          ====
+        TEMPLATE
+      end
+    end
+    register :example, Example.new
+  end
+end

data/lib/reverse_asciidoctor/converters/express_ref.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module ReverseAsciidoctor
+  module Converters
+    class ExpressRef < Base
+      def convert(node, _state = {})
+        "express_ref:[#{node['linkend']}]"
+      end
+    end
+    register :express_ref, ExpressRef.new
+  end
+end

data/lib/reverse_asciidoctor/converters/ext_description.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module ReverseAsciidoctor
+  module Converters
+    class ExtDescription < Base
+      def convert(node, state = {})
+        <<~TEMPLATE
+          (*"#{node['linkend']}"
+          #{treat_children(node, state)}
+          *)
+        TEMPLATE
+      end
+    end
+    register :ext_description, ExtDescription.new
+  end
+end

data/lib/reverse_asciidoctor/converters/ext_descriptions.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module ReverseAsciidoctor
+  module Converters
+    class ExtDescriptions < Base
+      def convert(node, state = {})
+        treat_children(node, state)
+      end
+    end
+    register :ext_descriptions, ExtDescriptions.new
+  end
+end

data/lib/reverse_asciidoctor/converters/img.rb

@@ -26,7 +26,7 @@ module ReverseAsciidoctor
         images_dir = dest_dir + 'images'
         FileUtils.mkdir_p(images_dir)
 
-        ext, image_src_path = determine_image_src_path(imgdata, src)
+        ext, image_src_path = determine_image_src_path(src, imgdata)
         image_dest_path = images_dir + "#{image_number}.#{ext}"
 
         # puts "image_dest_path: #{image_dest_path.to_s}"
@@ -38,7 +38,7 @@ module ReverseAsciidoctor
         image_dest_path.relative_path_from(dest_dir)
       end
 
-      def determine_image_src_path(imgdata, src)
+      def determine_image_src_path(src, imgdata)
         return copy_temp_file(imgdata) if imgdata
 
         ext = File.extname(src).strip.downcase[1..-1]

data/lib/reverse_asciidoctor/converters/note.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module ReverseAsciidoctor
+  module Converters
+    class Note < Base
+      def convert(node, state = {})
+        <<~TEMPLATE
+          [NOTE]
+          --
+          #{treat_children(node, state)}
+          --
+        TEMPLATE
+      end
+    end
+    register :note, Note.new
+  end
+end

data/lib/reverse_asciidoctor/html_converter.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require 'reverse_asciidoctor/converters/a'
+require 'reverse_asciidoctor/converters/aside'
+require 'reverse_asciidoctor/converters/audio'
+require 'reverse_asciidoctor/converters/blockquote'
+require 'reverse_asciidoctor/converters/br'
+require 'reverse_asciidoctor/converters/bypass'
+require 'reverse_asciidoctor/converters/code'
+require 'reverse_asciidoctor/converters/div'
+require 'reverse_asciidoctor/converters/drop'
+require 'reverse_asciidoctor/converters/em'
+require 'reverse_asciidoctor/converters/figure'
+require 'reverse_asciidoctor/converters/h'
+require 'reverse_asciidoctor/converters/head'
+require 'reverse_asciidoctor/converters/hr'
+require 'reverse_asciidoctor/converters/ignore'
+require 'reverse_asciidoctor/converters/img'
+require 'reverse_asciidoctor/converters/mark'
+require 'reverse_asciidoctor/converters/li'
+require 'reverse_asciidoctor/converters/ol'
+require 'reverse_asciidoctor/converters/p'
+require 'reverse_asciidoctor/converters/pass_through'
+require 'reverse_asciidoctor/converters/pre'
+require 'reverse_asciidoctor/converters/q'
+require 'reverse_asciidoctor/converters/strong'
+require 'reverse_asciidoctor/converters/sup'
+require 'reverse_asciidoctor/converters/sub'
+require 'reverse_asciidoctor/converters/table'
+require 'reverse_asciidoctor/converters/td'
+require 'reverse_asciidoctor/converters/th'
+require 'reverse_asciidoctor/converters/text'
+require 'reverse_asciidoctor/converters/tr'
+require 'reverse_asciidoctor/converters/video'
+require 'reverse_asciidoctor/converters/math'
+
+module ReverseAsciidoctor
+  class HtmlConverter
+    def self.convert(input, options = {})
+      root = if input.is_a?(String)
+              then Nokogiri::HTML(input).root
+            elsif input.is_a?(Nokogiri::XML::Document)
+              then input.root
+            elsif input.is_a?(Nokogiri::XML::Node)
+              then input
+            end
+
+      root || (return '')
+
+      ReverseAsciidoctor.config.with(options) do
+        result = ReverseAsciidoctor::Converters.lookup(root.name).convert(root)
+        ReverseAsciidoctor.cleaner.tidy(result)
+      end
+    end
+  end
+end

data/lib/reverse_asciidoctor/smrl_description_converter.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'reverse_asciidoctor/converters/a'
+require 'reverse_asciidoctor/converters/blockquote'
+require 'reverse_asciidoctor/converters/bypass'
+require 'reverse_asciidoctor/converters/br'
+require 'reverse_asciidoctor/converters/code'
+require 'reverse_asciidoctor/converters/drop'
+require 'reverse_asciidoctor/converters/em'
+require 'reverse_asciidoctor/converters/example'
+require 'reverse_asciidoctor/converters/ext_descriptions'
+require 'reverse_asciidoctor/converters/ext_description'
+require 'reverse_asciidoctor/converters/express_ref'
+require 'reverse_asciidoctor/converters/head'
+require 'reverse_asciidoctor/converters/hr'
+require 'reverse_asciidoctor/converters/ignore'
+require 'reverse_asciidoctor/converters/note'
+require 'reverse_asciidoctor/converters/p'
+require 'reverse_asciidoctor/converters/pass_through'
+require 'reverse_asciidoctor/converters/q'
+require 'reverse_asciidoctor/converters/strong'
+require 'reverse_asciidoctor/converters/sup'
+require 'reverse_asciidoctor/converters/sub'
+require 'reverse_asciidoctor/converters/text'
+
+module ReverseAsciidoctor
+  class SmrlDescriptionConverter
+    def self.convert(input, options = {})
+      root = if input.is_a?(String)
+                then Nokogiri::XML(input).root
+              elsif input.is_a?(Nokogiri::XML::Document)
+                then input.root
+              elsif input.is_a?(Nokogiri::XML::Node)
+                then input
+              end
+
+      root || (return '')
+
+      ReverseAsciidoctor.config.with(options) do
+        result = ReverseAsciidoctor::Converters.lookup(root.name).convert(root)
+        ReverseAsciidoctor.cleaner.tidy(result)
+      end
+    end
+  end
+end

data/lib/reverse_asciidoctor/version.rb

@@ -1,3 +1,3 @@
 module ReverseAsciidoctor
-  VERSION = '0.2.7'
+  VERSION = '0.2.8'
 end

data/spec/bin/reverse_adoc_spec.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe 'bin/revrse_adoc' do
+  subject(:convert) do
+    ShellUtils.execute!("./bin/reverse_adoc -e -o test1 #{input_file_path}")
+  end
+  unless Gem.win_platform?
+    context 'when external images present' do
+      let(:input_file_path) { 'spec/assets/external_images.html' }
+      let(:images_folder) { 'images' }
+
+      after do
+        FileUtils.rm_rf(images_folder) if File.directory?(images_folder)
+      end
+
+      it 'Does not raise error' do
+        expect { convert }.to_not raise_error
+      end
+
+      it 'exatracts images from source html' do
+        expect { convert }
+          .to(change do
+            Dir["#{images_folder}/*gif"]
+              .map { |entry| File.basename(entry) }
+              .sort
+          end.from([]).to(['001.gif']))
+      end
+    end
+  end
+end

data/spec/bin/w2a_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe 'bin/w2a' do
+  subject(:convert) do
+    ShellUtils.execute!("./bin/w2a -e -o test1 #{input_file_path}")
+  end
+  # TODO: fix github actions integration with libreoffice, currently it hangs
+  # when trying to use soffice binary
+  unless Gem.win_platform? ||
+         (Gem::Platform.local.os == 'darwin' && !ENV['GITHUB_ACTION'].nil?)
+    context 'when external images present' do
+      let(:input_file_path) { 'spec/assets/external_images.docx' }
+      let(:images_folder) { 'images' }
+
+      after do
+        FileUtils.rm_rf(images_folder) if File.directory?(images_folder)
+      end
+
+      it 'Does not raise error' do
+        expect { convert }.to_not raise_error
+      end
+
+      it 'exatracts images from source html' do
+        expect { convert }
+          .to(change do
+            Dir["#{images_folder}/*gif"]
+              .map { |entry| File.basename(entry) }
+              .sort
+          end.from([]).to(['001.gif', '002.gif']))
+      end
+    end
+  end
+end

data/spec/lib/reverse_asciidoctor/converters/example_spec.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'reverse_asciidoctor/converters/example'
+
+describe ReverseAsciidoctor::Converters::Example do
+  let(:converter) { described_class.new }
+  let(:output) do
+    <<~TEXT
+    [example]
+    ====
+     foo
+
+    ====
+    TEXT
+  end
+
+  it 'converts example` children' do
+    input = node_for('<example><li>foo</li></example>')
+    expect(converter.convert(input)).to eq(output)
+  end
+end

data/spec/lib/reverse_asciidoctor/converters/express_ref_spec.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'reverse_asciidoctor/converters/express_ref'
+
+describe ReverseAsciidoctor::Converters::ExpressRef do
+  let(:converter) { described_class.new }
+  let(:schema) { 'schema' }
+
+  it 'converts supplied tag by format' do
+    input = node_for("<express_ref linkend='#{schema}' />")
+    expect(converter.convert(input)).to eq("express_ref:[#{schema}]")
+  end
+end

data/spec/lib/reverse_asciidoctor/converters/ext_description_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'reverse_asciidoctor/converters/ext_description'
+
+describe ReverseAsciidoctor::Converters::ExtDescription do
+  let(:converter) { described_class.new }
+  let(:schema) { 'schema' }
+
+  it 'takes ext_description linkend attribute' do
+    input = node_for("<ext_description linkend='#{schema}'></ext_description>")
+    expect(converter.convert(input)).to include(%{(*"#{schema}"})
+  end
+
+  it 'converts html children' do
+    input = node_for(
+      "<ext_description linkend='#{schema}'><li>foo</li></ext_description>")
+    expect(converter.convert(input)).to include(" foo\n")
+  end
+end

data/spec/lib/reverse_asciidoctor/converters/ext_descriptions_spec.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'reverse_asciidoctor/converters/ext_descriptions'
+
+describe ReverseAsciidoctor::Converters::ExtDescriptions do
+  let(:converter) { described_class.new }
+
+  it 'converts ext_descriptions children' do
+    input = node_for('<ext_descriptions><li>foo</li></ext_descriptions>')
+    expect(converter.convert(input)).to eq " foo\n"
+  end
+end

data/spec/lib/reverse_asciidoctor/converters/note_spec.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'reverse_asciidoctor/converters/note'
+
+describe ReverseAsciidoctor::Converters::Note do
+  let(:converter) { described_class.new }
+  let(:output) do
+    <<~TEXT
+    [NOTE]
+    --
+     foo
+
+    --
+    TEXT
+  end
+
+  it 'converts note` children' do
+    input = node_for('<note><li>foo</li></note>')
+    expect(converter.convert(input)).to eq(output)
+  end
+end

data/spec/lib/reverse_asciidoctor_spec.rb

@@ -4,19 +4,19 @@ describe ReverseAsciidoctor do
   let(:input)    { File.read('spec/assets/minimum.html') }
   let(:document) { Nokogiri::HTML(input) }
 
-  it "parses nokogiri documents" do
+  it 'parses nokogiri documents' do
     expect { ReverseAsciidoctor.convert(document) }.not_to raise_error
   end
 
-  it "parses nokogiri elements" do
+  it 'parses nokogiri elements' do
     expect { ReverseAsciidoctor.convert(document.root) }.not_to raise_error
   end
 
-  it "parses string input" do
+  it 'parses string input' do
     expect { ReverseAsciidoctor.convert(input) }.not_to raise_error
   end
 
-  it "behaves in a sane way when root element is nil" do
+  it 'behaves in a sane way when root element is nil' do
     expect(ReverseAsciidoctor.convert(nil)).to eq ''
   end
 
@@ -28,10 +28,63 @@ describe ReverseAsciidoctor do
 
     it 'can be used as a block configurator as well' do
       ReverseAsciidoctor.config do |config|
-        expect(config.tag_border).to eq " "
+        expect(config.tag_border).to eq ' '
         config.tag_border = true
       end
       expect(ReverseAsciidoctor.config.tag_border).to eq true
     end
   end
+
+  shared_examples 'converting source with external images included' do |result|
+    let(:temp_dir) do
+      Pathname.new(ReverseAsciidoctor.config.destination).dirname
+    end
+    let(:images_folder) { File.join(temp_dir, 'images') }
+
+    before do
+      ReverseAsciidoctor.config.destination = File.join(Dir.mktmpdir,
+                                                        'output.html')
+      ReverseAsciidoctor.config.sourcedir = Dir.mktmpdir
+      ReverseAsciidoctor.config.external_images = true
+    end
+
+    after do
+      FileUtils.rm_rf(temp_dir)
+    end
+
+    it 'Creates local files from external URI' do
+      expect { convert }
+        .to(change do
+          Dir["#{images_folder}/*gif"]
+            .map { |entry| File.basename(entry) }
+            .sort
+        end.from([]).to(result))
+    end
+  end
+
+  # TODO: fix github actions integration with libreoffice, currently it hangs
+  # when trying to use soffice binary
+  unless Gem::Platform.local.os == 'darwin' && !ENV['GITHUB_ACTION'].nil?
+    context 'when docx file input' do
+      subject(:convert) do
+        ReverseAsciidoctor.convert(
+          ReverseAsciidoctor.cleaner.preprocess_word_html(input.document.html),
+          WordToMarkdown::REVERSE_MARKDOWN_OPTIONS
+        )
+      end
+      let(:input) do
+        WordToMarkdown.new('spec/assets/external_images.docx',
+                           ReverseAsciidoctor.config.sourcedir)
+      end
+      it_behaves_like 'converting source with external images included',
+                      ['001.gif', '002.gif']
+    end
+  end
+
+  context 'when html file input' do
+    subject(:convert) { ReverseAsciidoctor.convert(input) }
+    let(:input) { File.read('spec/assets/external_images.html') }
+    it_behaves_like 'converting source with external images included',
+                    ['001.gif']
+  end
 end

data/spec/spec_helper.rb

@@ -9,6 +9,11 @@ end
 SimpleCov.start 'gem'
 
 require 'reverse_asciidoctor'
+require 'reverse_asciidoctor/html_converter'
+require 'word-to-markdown'
+
+Dir[File.join('spec', 'support', '**', '*.rb')]
+  .each { |f| require File.join('.', f) }
 
 RSpec.configure do |config|
   config.after(:each) do

data/spec/support/shell_helpers.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'open3'
+
+module ShellUtils
+  class ShellExcutionError < StandardError; end
+  module_function
+
+  def execute!(cmd)
+    stdout, stderr, status = Open3.capture3(cmd)
+    raise(ShellExcutionError, stderr) unless status.success?
+
+    stdout
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: reverse_adoc
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.8
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-12 00:00:00.000000000 Z
+date: 2020-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -151,6 +151,7 @@ files:
 - ".hound.yml"
 - ".rubocop.yml"
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.adoc
 - Rakefile
@@ -171,6 +172,10 @@ files:
 - lib/reverse_asciidoctor/converters/div.rb
 - lib/reverse_asciidoctor/converters/drop.rb
 - lib/reverse_asciidoctor/converters/em.rb
+- lib/reverse_asciidoctor/converters/example.rb
+- lib/reverse_asciidoctor/converters/express_ref.rb
+- lib/reverse_asciidoctor/converters/ext_description.rb
+- lib/reverse_asciidoctor/converters/ext_descriptions.rb
 - lib/reverse_asciidoctor/converters/figure.rb
 - lib/reverse_asciidoctor/converters/h.rb
 - lib/reverse_asciidoctor/converters/head.rb
@@ -180,6 +185,7 @@ files:
 - lib/reverse_asciidoctor/converters/li.rb
 - lib/reverse_asciidoctor/converters/mark.rb
 - lib/reverse_asciidoctor/converters/math.rb
+- lib/reverse_asciidoctor/converters/note.rb
 - lib/reverse_asciidoctor/converters/ol.rb
 - lib/reverse_asciidoctor/converters/p.rb
 - lib/reverse_asciidoctor/converters/pass_through.rb
@@ -195,12 +201,16 @@ files:
 - lib/reverse_asciidoctor/converters/tr.rb
 - lib/reverse_asciidoctor/converters/video.rb
 - lib/reverse_asciidoctor/errors.rb
+- lib/reverse_asciidoctor/html_converter.rb
+- lib/reverse_asciidoctor/smrl_description_converter.rb
 - lib/reverse_asciidoctor/version.rb
 - reverse_adoc.gemspec
 - spec/assets/anchors.html
 - spec/assets/basic.html
 - spec/assets/code.html
 - spec/assets/escapables.html
+- spec/assets/external_images.docx
+- spec/assets/external_images.html
 - spec/assets/from_the_wild.html
 - spec/assets/full_example.html
 - spec/assets/html_fragment.html
@@ -209,9 +219,9 @@ files:
 - spec/assets/paragraphs.html
 - spec/assets/quotation.html
 - spec/assets/tables.html
-- spec/assets/test.docx
-- spec/assets/test.html
 - spec/assets/unknown_tags.html
+- spec/bin/reverse_adoc_spec.rb
+- spec/bin/w2a_spec.rb
 - spec/components/anchors_spec.rb
 - spec/components/basic_spec.rb
 - spec/components/code_spec.rb
@@ -231,10 +241,15 @@ files:
 - spec/lib/reverse_asciidoctor/converters/br_spec.rb
 - spec/lib/reverse_asciidoctor/converters/code_spec.rb
 - spec/lib/reverse_asciidoctor/converters/div_spec.rb
+- spec/lib/reverse_asciidoctor/converters/example_spec.rb
+- spec/lib/reverse_asciidoctor/converters/express_ref_spec.rb
+- spec/lib/reverse_asciidoctor/converters/ext_description_spec.rb
+- spec/lib/reverse_asciidoctor/converters/ext_descriptions_spec.rb
 - spec/lib/reverse_asciidoctor/converters/figure_spec.rb
 - spec/lib/reverse_asciidoctor/converters/img_spec.rb
 - spec/lib/reverse_asciidoctor/converters/li_spec.rb
 - spec/lib/reverse_asciidoctor/converters/mark_spec.rb
+- spec/lib/reverse_asciidoctor/converters/note_spec.rb
 - spec/lib/reverse_asciidoctor/converters/p_spec.rb
 - spec/lib/reverse_asciidoctor/converters/pre_spec.rb
 - spec/lib/reverse_asciidoctor/converters/q_spec.rb
@@ -244,6 +259,7 @@ files:
 - spec/lib/reverse_asciidoctor/converters_spec.rb
 - spec/lib/reverse_asciidoctor_spec.rb
 - spec/spec_helper.rb
+- spec/support/shell_helpers.rb
 homepage: http://github.com/metanorma/reverse_adoc
 licenses:
 - BSD-2-Clause
@@ -263,8 +279,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: Generate AsciiDoc from HTML and Microsoft Word via CLI or library.
@@ -273,6 +288,8 @@ test_files:
 - spec/assets/basic.html
 - spec/assets/code.html
 - spec/assets/escapables.html
+- spec/assets/external_images.docx
+- spec/assets/external_images.html
 - spec/assets/from_the_wild.html
 - spec/assets/full_example.html
 - spec/assets/html_fragment.html
@@ -281,9 +298,9 @@ test_files:
 - spec/assets/paragraphs.html
 - spec/assets/quotation.html
 - spec/assets/tables.html
-- spec/assets/test.docx
-- spec/assets/test.html
 - spec/assets/unknown_tags.html
+- spec/bin/reverse_adoc_spec.rb
+- spec/bin/w2a_spec.rb
 - spec/components/anchors_spec.rb
 - spec/components/basic_spec.rb
 - spec/components/code_spec.rb
@@ -303,10 +320,15 @@ test_files:
 - spec/lib/reverse_asciidoctor/converters/br_spec.rb
 - spec/lib/reverse_asciidoctor/converters/code_spec.rb
 - spec/lib/reverse_asciidoctor/converters/div_spec.rb
+- spec/lib/reverse_asciidoctor/converters/example_spec.rb
+- spec/lib/reverse_asciidoctor/converters/express_ref_spec.rb
+- spec/lib/reverse_asciidoctor/converters/ext_description_spec.rb
+- spec/lib/reverse_asciidoctor/converters/ext_descriptions_spec.rb
 - spec/lib/reverse_asciidoctor/converters/figure_spec.rb
 - spec/lib/reverse_asciidoctor/converters/img_spec.rb
 - spec/lib/reverse_asciidoctor/converters/li_spec.rb
 - spec/lib/reverse_asciidoctor/converters/mark_spec.rb
+- spec/lib/reverse_asciidoctor/converters/note_spec.rb
 - spec/lib/reverse_asciidoctor/converters/p_spec.rb
 - spec/lib/reverse_asciidoctor/converters/pre_spec.rb
 - spec/lib/reverse_asciidoctor/converters/q_spec.rb
@@ -316,3 +338,4 @@ test_files:
 - spec/lib/reverse_asciidoctor/converters_spec.rb
 - spec/lib/reverse_asciidoctor_spec.rb
 - spec/spec_helper.rb
+- spec/support/shell_helpers.rb