asciidoctor-dita-topic 1.4.3 → 1.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11fd5a1643d253674e558d4f693b877f21ac76fe0187778145610d1c7f2fbe08
-  data.tar.gz: 647dd1a9354135c1da3585980cb5b3033518663ae14747eed89ab8e292ac2c3d
+  metadata.gz: 8f6ab85df9ce5321111233e1d6010ffbaff45ef483429b52f1c4f1e21b24a599
+  data.tar.gz: 3032b2f55d0e62d5259ab80172c0ae6e22c64d0dad22d6af3e93de9b16432429
 SHA512:
-  metadata.gz: aae2ef4be77c4cb0501f2c178813f1bf867168b49409a55f3671e5c87cf4d69f1d60ed3cccf4cd3efbf91b81dd26890cea83559083396c658be9745ed0b5a9a0
-  data.tar.gz: d799dc9c5b8ba1a04e86cc98b8dd857a2a9e50e010b145f6fdf12f9c3ea14a7bc32293c3d435fafb4c9e36df2cc1491f485e80756dd1197b4a81b96027384677
+  metadata.gz: 3a0b76fb1014db44d1b4480ba9b3769104651ef209e74b3557e8c4834719ae44982604d7423729c3a57fdd226e275fe07bca439239cf8eb574c6b7d0f7b8a0be
+  data.tar.gz: c0b2aeb4ffc8bd7c21ff1cb26ea9112eb48b651e7137c696a2a2dda4789077f9e98ce754d04c2ede6523a0380d89527f1846a27549951442252e0e38b5e23bd4

data/lib/dita-topic/cli.rb

@@ -22,6 +22,7 @@
 # OTHER DEALINGS IN THE SOFTWARE.
 
 require 'optparse'
+require 'pathname'
 require 'asciidoctor'
 require_relative 'version'
 require_relative '../dita-topic'
@@ -30,7 +31,12 @@ module AsciidoctorDitaTopic
   class Cli
     def initialize name, argv
       @attr = ['experimental']
-      @opts = {:output => true, :includes => true, :standalone => true}
+      @opts = {
+        :output => false,
+        :includes => true,
+        :standalone => true,
+        :map => false
+      }
       @prep = []
       @name = name
       @args = self.parse_args argv
@@ -41,15 +47,25 @@ module AsciidoctorDitaTopic
         opt.banner  = "Usage: #{@name} [OPTION...] [FILE...]\n"
         opt.banner += "       #{@name} -h|-v\n\n"
 
-        opt.on('-o', '--out-file FILE', 'output file; by default, the output file name is based on the input file') do |output|
+        opt.on('-o', '--out-file FILE', 'specify the output file; by default, the output file name is based on the input file') do |output|
           @opts[:output] = (output.strip == '-') ? $stdout : output
         end
 
-        opt.on('-a', '--attribute ATTRIBUTE', 'document attribute to set in the form of name, name!, or name=value pair') do |value|
+        opt.on('-a', '--attribute ATTRIBUTE', 'set a document attribute in the form of name, name!, or name=value pair; can be supplied multiple times') do |value|
           @attr.append value
         end
 
-        opt.on('-p', '--prepend-file FILE', 'file to prepend to all input files') do |file|
+        opt.on('-s', '--no-header-footer', 'disable enclosing the content in <topic> and generating <title>') do
+          @opts[:standalone] = false
+        end
+
+        opt.separator ''
+
+        opt.on('-m', '--dita-map', 'generate a DITA map instead of a topic') do
+          @opts[:map] = true
+        end
+
+        opt.on('-p', '--prepend-file FILE', 'prepend a file to all input files; can be supplied multiple times') do |file|
           raise OptionParser::InvalidArgument, "not a file: #{file}" unless File.exist? file and File.file? file
           raise OptionParser::InvalidArgument, "file not readable: #{file}" unless File.readable? file
 
@@ -60,10 +76,6 @@ module AsciidoctorDitaTopic
           @opts[:includes] = false
         end
 
-        opt.on('-s', '--no-header-footer', 'disable enclosing the content in <topic> and generating <title>') do
-          @opts[:standalone] = false
-        end
-
         opt.separator ''
 
         opt.on('-l', '--author-line', 'enable processing of author lines as metadata') do
@@ -113,6 +125,83 @@ module AsciidoctorDitaTopic
       return args
     end
 
+    def convert_map file, input, output
+      if file == $stdin
+        base_dir = Pathname.new(Dir.pwd).expand_path
+        offset   = 0
+      else
+        base_dir = Pathname.new(file).dirname.expand_path
+        file     = Pathname.new(file).sub_ext('.dita').basename
+        offset   = 1
+      end
+
+      doc        = Asciidoctor.load input, backend: 'dita-topic', safe: :unsafe, attributes: @attr, base_dir: base_dir, sourcemap: true
+      sections   = doc.find_by context: :section
+
+      return unless sections
+
+      title      = (sections.first.level == 0 and sections.first.title) ? sections.first.title : false
+
+      if @opts[:standalone]
+        result   = ["<?xml version='1.0' encoding='utf-8' ?>"]
+        result  << %(<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">)
+        result  << %(<map>)
+        result  << %(  <title>#{title}</title>) if title
+      else
+        result   = []
+      end
+
+      last_level = 0
+      last_file  = ''
+
+      sections.each_index do |i|
+        section  = sections[i]
+        level    = section.level
+        title    = section.title.gsub(/"|<[^>]*>|[<>]/, '')
+        filename = section.file ? Pathname.new(section.file).sub_ext('.dita').relative_path_from(base_dir) : Pathname.new(file)
+        current  = last_level
+
+        next if filename == last_file
+
+        while current > level
+          current -= 1
+          result << '  ' * (current + offset) + %(</topicref>)
+        end
+
+        if level - last_level > 1
+          warn "WARNING: #{filename.basename}: line #{section.lineno}: section title out of sequence: expected level #{last_level + 1}, got level #{level}"
+          level = last_level + 1
+        end
+
+        indent  = '  ' * (level + offset)
+        parent  = (sections[i + 1] and sections[i + 1].level > level) ? true : false
+        result << indent + %(<topicref href="#{filename}" navtitle="#{title}"#{parent ? '>' : ' />'}) unless filename == $stdin
+
+        last_level = level
+        last_file  = filename
+      end
+
+      while last_level > 0
+        last_level -= 1
+        break if last_level == 0 and file == $stdin
+        result << '  ' * (last_level + offset) + %(</topicref>)
+      end
+
+      if @opts[:standalone]
+        result << %(</map>)
+      end
+
+      if output == $stdout
+        $stdout.write result.join("\n")
+      else
+        File.write output, result.join("\n")
+      end
+    end
+
+    def convert_topic input, output
+      Asciidoctor.convert input, backend: 'dita-topic', standalone: @opts[:standalone], safe: :unsafe, attributes: @attr, to_file: output
+    end
+
     def run
       prepended = ''
 
@@ -124,15 +213,20 @@ module AsciidoctorDitaTopic
       @args.each do |file|
         if file == $stdin
           input  = $stdin.read
-          output = (@opts[:output] == true) ? $stdout : @opts[:output]
+          output = @opts[:output] ? @opts[:output] : $stdout
         else
+          suffix = @opts[:map] ? '.ditamap' : '.dita'
           input  = File.read(file)
-          output = (@opts[:output] == true) ? Pathname.new(file).sub_ext('.dita').to_s : @opts[:output]
+          output = @opts[:output] ? @opts[:output] : Pathname.new(file).sub_ext(suffix).to_s
         end
 
         input.gsub!(Asciidoctor::IncludeDirectiveRx, '//\&') unless @opts[:includes]
 
-        Asciidoctor.convert prepended + input, backend: 'dita-topic', standalone: @opts[:standalone], safe: :unsafe, attributes: @attr, to_file: output
+        if @opts[:map]
+          convert_map file, prepended + input, output
+        else
+          convert_topic prepended + input, output
+        end
       end
     end
   end

data/lib/dita-topic/version.rb

@@ -24,5 +24,5 @@
 # frozen_string_literal: true
 
 module AsciidoctorDitaTopic
-  VERSION     = '1.4.3'
+  VERSION     = '1.4.5'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-dita-topic
 version: !ruby/object:Gem::Version
-  version: 1.4.3
+  version: 1.4.5
 platform: ruby
 authors:
 - Jaromir Hradilek