review 3.0.0.preview3 → 3.0.0.preview4

data/lib/review/idgxmlbuilder.rb

@@ -264,14 +264,7 @@ module ReVIEW
     end
 
     def inline_list(id)
-      chapter, id = extract_chapter_id(id)
-      if get_chap(chapter).nil?
-        "<span type='list'>#{I18n.t('list')}#{I18n.t('format_number_without_chapter', [chapter.list(id).number])}</span>"
-      else
-        "<span type='list'>#{I18n.t('list')}#{I18n.t('format_number', [get_chap(chapter), chapter.list(id).number])}</span>"
-      end
-    rescue KeyError
-      error "unknown list: #{id}"
+      "<span type='list'>#{super(id)}</span>"
     end
 
     def list_header(id, caption, _lang)
@@ -369,25 +362,15 @@ module ReVIEW
     end
 
     def inline_table(id)
-      chapter, id = extract_chapter_id(id)
-      if get_chap(chapter).nil?
-        "<span type='table'>#{I18n.t('table')}#{I18n.t('format_number_without_chapter', [chapter.table(id).number])}</span>"
-      else
-        "<span type='table'>#{I18n.t('table')}#{I18n.t('format_number', [get_chap(chapter), chapter.table(id).number])}</span>"
-      end
-    rescue KeyError
-      error "unknown table: #{id}"
+      "<span type='table'>#{super(id)}</span>"
     end
 
     def inline_img(id)
-      chapter, id = extract_chapter_id(id)
-      if get_chap(chapter).nil?
-        "<span type='image'>#{I18n.t('image')}#{I18n.t('format_number_without_chapter', [chapter.image(id).number])}</span>"
-      else
-        "<span type='image'>#{I18n.t('image')}#{I18n.t('format_number', [get_chap(chapter), chapter.image(id).number])}</span>"
-      end
-    rescue KeyError
-      error "unknown image: #{id}"
+      "<span type='image'>#{super(id)}</span>"
+    end
+
+    def inline_eq(id)
+      "<span type='eq'>#{super(id)}</span>"
     end
 
     def inline_imgref(id)
@@ -440,13 +423,26 @@ module ReVIEW
       end
     end
 
-    def texequation(lines)
+    def texequation(lines, id = nil, caption = '')
       @texblockequation += 1
+      if id
+        puts '<equationblock>'
+        if get_chap.nil?
+          puts %Q(<caption>#{I18n.t('equation')}#{I18n.t('format_number_without_chapter', [@chapter.equation(id).number])}#{I18n.t('caption_prefix_idgxml')}#{compile_inline(caption)}</caption>)
+        else
+          puts %Q(<caption>#{I18n.t('equation')}#{I18n.t('format_number', [get_chap, @chapter.equation(id).number])}#{I18n.t('caption_prefix_idgxml')}#{compile_inline(caption)}</caption>)
+        end
+      end
+
       puts %Q(<replace idref="texblock-#{@texblockequation}">)
       puts '<pre>'
       puts lines.join("\n")
       puts '</pre>'
       puts '</replace>'
+
+      if id
+        puts '</equationblock>'
+      end
     end
 
     def table(lines, id = nil, caption = nil)
@@ -1067,20 +1063,30 @@ module ReVIEW
     end
 
     def inline_chapref(id)
-      chs = ['', '「', '」']
-      if @book.config['chapref']
-        chs2 = @book.config['chapref'].split(',')
-        if chs2.size != 3
-          error '--chapsplitter must have exactly 3 parameters with comma.'
+      if @book.config.check_version('2', exception: false)
+        # backward compatibility
+        chs = ['', '「', '」']
+        if @book.config['chapref']
+          chs2 = @book.config['chapref'].split(',')
+          if chs2.size != 3
+            error '--chapsplitter must have exactly 3 parameters with comma.'
+          else
+            chs = chs2
+          end
+        end
+        s = "#{chs[0]}#{@book.chapter_index.number(id)}#{chs[1]}#{@book.chapter_index.title(id)}#{chs[2]}"
+        if @book.config['chapterlink']
+          %Q(<link href="#{id}">#{s}</link>)
         else
-          chs = chs2
+          s
         end
-      end
-      s = "#{chs[0]}#{@book.chapter_index.number(id)}#{chs[1]}#{@book.chapter_index.title(id)}#{chs[2]}"
-      if @book.config['chapterlink']
-        %Q(<link href="#{id}">#{s}</link>)
       else
-        s
+        title = super
+        if @book.config['chapterlink']
+          %Q(<link href="#{id}">#{title}</link>)
+        else
+          title
+        end
       end
     rescue KeyError
       error "unknown chapter: #{id}"

data/lib/review/init.rb

@@ -170,13 +170,13 @@ EOS
 
       File.open(dir + '/Rakefile', 'w') do |file|
         file.write <<-EOS
-Dir.glob('lib/tasks/*.rake').each do |file|
+Dir.glob('lib/tasks/*.rake').sort.each do |file|
   load(file)
 end
 EOS
       end
 
-      FileUtils.cp(@review_dir + '/samples/sample-book/src/Rakefile',
+      FileUtils.cp(@review_dir + '/samples/sample-book/src/lib/tasks/review.rake',
                    dir + '/lib/tasks/review.rake')
     end
 

data/lib/review/latexbuilder.rb

@@ -733,13 +733,28 @@ module ReVIEW
       latex_block 'flushright', lines
     end
 
-    def texequation(lines)
+    def texequation(lines, id = nil, caption = '')
       blank
+
+      if id
+        puts macro('begin', 'reviewequationblock')
+        if get_chap.nil?
+          puts macro('reviewequationcaption', "#{I18n.t('equation')}#{I18n.t('format_number_header_without_chapter', [@chapter.equation(id).number])}#{I18n.t('caption_prefix')}#{compile_inline(caption)}")
+        else
+          puts macro('reviewequationcaption', "#{I18n.t('equation')}#{I18n.t('format_number_header', [get_chap, @chapter.equation(id).number])}#{I18n.t('caption_prefix')}#{compile_inline(caption)}")
+        end
+      end
+
       puts macro('begin', 'equation*')
       lines.each do |line|
         puts unescape(line)
       end
       puts macro('end', 'equation*')
+
+      if id
+        puts macro('end', 'reviewequationblock')
+      end
+
       blank
     end
 
@@ -863,6 +878,17 @@ module ReVIEW
       error "unknown image: #{id}"
     end
 
+    def inline_eq(id)
+      chapter, id = extract_chapter_id(id)
+      if get_chap(chapter).nil?
+        macro('reviewequationref', I18n.t('format_number_without_chapter', [chapter.equation(id).number]))
+      else
+        macro('reviewequationref', I18n.t('format_number', [get_chap(chapter), chapter.equation(id).number]))
+      end
+    rescue KeyError
+      error "unknown equation: #{id}"
+    end
+
     def footnote(id, content)
       if @book.config['footnotetext'] || @foottext[id]
         puts macro("footnotetext[#{@chapter.footnote(id).number}]", compile_inline(content.strip))

data/lib/review/makerhelper.rb

@@ -75,7 +75,7 @@ module ReVIEW
 
     def default_imgmath_preamble
       <<-EOB
-\\documentclass[uplatex]{jsarticle}
+\\documentclass[uplatex,a3paper,landscape]{jsarticle}
 \\usepackage[deluxe,uplatex]{otf}
 \\usepackage[T1]{fontenc}
 \\usepackage{textcomp}
@@ -92,6 +92,7 @@ module ReVIEW
 \\usepackage{anyfontsize}
 \\usepackage{bm}
 \\pagestyle{empty}
+% \\setpaperwidth{1000mm}
     EOB
     end
 

data/lib/review/plaintextbuilder.rb

@@ -137,17 +137,6 @@ module ReVIEW
 
     alias_method :lead, :read
 
-    def inline_list(id)
-      chapter, id = extract_chapter_id(id)
-      if get_chap(chapter)
-        %Q(#{I18n.t('list')}#{I18n.t('format_number', [get_chap(chapter), chapter.list(id).number])})
-      else
-        %Q(#{I18n.t('list')}#{I18n.t('format_number_without_chapter', [chapter.list(id).number])})
-      end
-    rescue KeyError
-      error "unknown list: #{id}"
-    end
-
     def list_header(id, caption, _lang)
       blank
       if get_chap
@@ -207,28 +196,6 @@ module ReVIEW
       base_parablock 'quote', lines, nil
     end
 
-    def inline_table(id)
-      chapter, id = extract_chapter_id(id)
-      if get_chap(chapter)
-        "#{I18n.t('table')}#{I18n.t('format_number', [get_chap(chapter), chapter.table(id).number])}"
-      else
-        "#{I18n.t('table')}#{I18n.t('format_number_without_chapter', [chapter.table(id).number])}"
-      end
-    rescue KeyError
-      error "unknown table: #{id}"
-    end
-
-    def inline_img(id)
-      chapter, id = extract_chapter_id(id)
-      if get_chap(chapter)
-        "#{I18n.t('image')}#{I18n.t('format_number', [get_chap(chapter), chapter.image(id).number])}"
-      else
-        "#{I18n.t('image')}#{I18n.t('format_number_without_chapter', [chapter.image(id).number])}"
-      end
-    rescue KeyError
-      error "unknown image: #{id}"
-    end
-
     def image(_lines, id, caption, _metric = nil)
       blank
       if get_chap
@@ -239,7 +206,16 @@ module ReVIEW
       blank
     end
 
-    def texequation(lines)
+    def texequation(lines, id = nil, caption = '')
+      if id
+        blank
+        if get_chap
+          puts "#{I18n.t('equation')}#{I18n.t('format_number', [get_chap, @chapter.equation(id).number])}#{I18n.t('caption_prefix_idgxml')}#{compile_inline(caption)}"
+        else
+          puts "#{I18n.t('equation')}#{I18n.t('format_number_without_chapter', [@chapter.equation(id).number])}#{I18n.t('caption_prefix_idgxml')}#{compile_inline(caption)}"
+        end
+      end
+
       puts lines.join("\n")
       blank
     end
@@ -623,15 +599,25 @@ module ReVIEW
     end
 
     def inline_chapref(id)
-      chs = ['', '「', '」']
-      if @book.config['chapref']
-        chs2 = @book.config['chapref'].split(',')
-        if chs2.size != 3
-          error '--chapsplitter must have exactly 3 parameters with comma.'
+      if @book.config.check_version('2', exception: false)
+        # backward compatibility
+        chs = ['', '「', '」']
+        if @book.config['chapref']
+          chs2 = @book.config['chapref'].split(',')
+          if chs2.size != 3
+            error '--chapsplitter must have exactly 3 parameters with comma.'
+          end
+          chs = chs2
+        end
+        "#{chs[0]}#{@book.chapter_index.number(id)}#{chs[1]}#{@book.chapter_index.title(id)}#{chs[2]}"
+      else
+        title = super
+        if @book.config['chapterlink']
+          %Q(<link href="#{id}">#{title}</link>)
+        else
+          title
         end
-        chs = chs2
       end
-      "#{chs[0]}#{@book.chapter_index.number(id)}#{chs[1]}#{@book.chapter_index.title(id)}#{chs[2]}"
     rescue KeyError
       error "unknown chapter: #{id}"
     end

data/lib/review/rstbuilder.rb

@@ -297,11 +297,19 @@ module ReVIEW
       blank
     end
 
-    def texequation(lines)
+    def texequation(lines, id = nil, caption = '')
+      if id
+        puts ".. _#{id}:"
+      end
+
       puts '.. math::'
       blank
       puts lines.map { |line| "   #{line}" }.join
       blank
+      if caption.present?
+        puts "   #{caption}"
+        blank
+      end
     end
 
     def table_header(id, caption)

data/lib/review/topbuilder.rb

@@ -170,8 +170,16 @@ module ReVIEW
       blank
     end
 
-    def texequation(lines)
+    def texequation(lines, id = nil, caption = '')
+      blank
       puts "◆→開始:#{@titles['texequation']}←◆"
+      if id
+        if get_chap
+          puts "#{I18n.t('equation')}#{I18n.t('format_number', [get_chap, @chapter.equation(id).number])}#{I18n.t('caption_prefix_idgxml')}#{compile_inline(caption)}"
+        else
+          puts "#{I18n.t('equation')}#{I18n.t('format_number_without_chapter', [@chapter.equation(id).number])}#{I18n.t('caption_prefix_idgxml')}#{compile_inline(caption)}"
+        end
+      end
       puts lines.join("\n")
       puts "◆→終了:#{@titles['texequation']}←◆"
       blank

data/lib/review/update.rb

@@ -0,0 +1,527 @@
+#
+# Copyright (c) 2018 Kenshi Muto
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+# For details of the GNU LGPL, see the file "COPYING".
+
+require 'fileutils'
+require 'optparse'
+require 'review'
+require 'review/i18n'
+require 'yaml'
+require 'digest'
+
+module ReVIEW
+  class Update
+    def self.execute(*args)
+      new.execute(*args)
+    end
+
+    # should be
+    TARGET_VERSION = '3.0'
+    EPUB_VERSION = '3'
+    HTML_VERSION = '5'
+    TEX_DOCUMENTCLASS = ['review-jsbook', 'review-jlreq']
+    TEX_DOCUMENTCLASS_BAD = ['jsbook', nil]
+    TEX_DOCUMENTCLASS_OPTS = 'cameraready=print,paper=a5'
+    TEX_COMMAND = 'uplatex'
+    TEX_OPTIONS = '-interaction=nonstopmode -file-line-error'
+    DVI_COMMAND = 'dvipdfmx'
+    DVI_OPTIONS = '-d 5 -z 9'
+
+    attr_reader :config_ymls, :locale_ymls, :catalog_ymls, :tex_ymls, :epub_ymls
+    attr_accessor :force, :specified_template
+
+    def initialize
+      @template = nil
+      @specified_template = nil
+      @force = nil
+      @logger = ReVIEW.logger
+      @review_dir = File.dirname(File.expand_path('..', __dir__))
+      @config_ymls = []
+      @locale_ymls = []
+      @catalog_ymls = []
+      @tex_ymls = []
+      @epub_ymls = []
+
+      @backup = true
+    end
+
+    def execute(*args)
+      parse_options(args)
+      dir = Dir.pwd
+
+      parse_ymls(dir)
+      check_old_catalogs(dir)
+
+      show_version
+
+      if @config_ymls.empty?
+        @logger.error t("!! No *.yml file with 'review_version' was found. Aborted. !!")
+        raise ApplicationError
+      end
+
+      check_own_files(dir)
+      update_version
+      update_rakefile(dir)
+      update_epub_version
+      update_locale
+      update_tex_parameters
+      if @template
+        update_tex_stys(@template, dir)
+      end
+      update_tex_command
+      update_dvi_command
+
+      puts t('Finished.')
+    rescue ApplicationError
+      exit 1
+    end
+
+    def t(message, args = [])
+      unless I18n.get(message)
+        I18n.set(message, message) # just copy
+      end
+      I18n.t(message, args)
+    end
+
+    def confirm(message, args = [], default = true)
+      if @force
+        @logger.info t(message, args)
+        if default
+          @logger.info ' yes'
+          return true
+        else
+          @logger.info 'no'
+          return nil
+        end
+      end
+
+      loop do
+        print t(message, args)
+        if default
+          print ' [y]/n '
+        else
+          print ' y/[n] '
+        end
+        case gets.chomp.downcase
+        when 'yes', 'y'
+          return true
+        when 'no', 'n'
+          return nil
+        when ''
+          return default
+        end
+      end
+    end
+
+    def rewrite_yml(yml, key, val)
+      content = File.read(yml)
+      content.gsub!(/^(\s*)#{key}:.*$/, '\1' + "#{key}: #{val}")
+      if @backup
+        FileUtils.mv yml, "#{yml}-old"
+      end
+      File.write(yml, content)
+    end
+
+    def parse_options(args)
+      opts = OptionParser.new
+      opts.version = ReVIEW::VERSION
+      opts.banner = "Usage: #{File.basename($PROGRAM_NAME)} [option]"
+      opts.on('-h', '--help', 'print this message and quit.') do
+        puts opts.help
+        exit 0
+      end
+      opts.on('--latex-template name', 'specify LaTeX template name. (default: review-jsbook)') do |tname|
+        @specified_template = tname
+      end
+
+      begin
+        opts.parse!(args)
+      rescue OptionParser::ParseError => err
+        @logger.error err.message
+        $stderr.puts opts.help
+        raise ApplicationError
+      end
+
+      if @specified_template
+        tdir = File.join(@review_dir, 'templates/latex', @specified_template)
+        unless File.exist?(tdir)
+          @logger.error "!! #{tdir} not found. Aborted. !!"
+          raise ApplicationError
+        end
+      end
+    end
+
+    def parse_ymls(dir)
+      language = 'en'
+
+      Dir.glob(File.join(dir, '*.yml')).sort.each do |yml|
+        begin
+          config = YAML.load_file(yml)
+          if config['language'].present?
+            language = config['language']
+          end
+
+          if config['review_version'].present?
+            @config_ymls.push(yml)
+          end
+          if config['texdocumentclass'].present? ||
+             config['texcommand'].present? ||
+             config['texoptions'].present? ||
+             config['dvicommand'].present? ||
+             config['dvioptions'].present? ||
+             config['pdfmaker'].present?
+            @tex_ymls.push(yml)
+          end
+          if config['epubmaker'].present? || config['epubversion'].present? ||
+             config['htmlversion'].present?
+            @epub_ymls.push(yml)
+          end
+          if config['locale'].present?
+            @locale_ymls.push(yml)
+          end
+          if config['PREDEF'].present? || config['CHAPS'].present? ||
+             config['APPENDIX'].present? || config['POSTDEF'].present?
+            @catalog_ymls.push(yml)
+          end
+        rescue Psych::SyntaxError
+          @logger.error "!! #{yml} is broken. Ignored. !!"
+        end
+      end
+      I18n.setup(language)
+
+      @config_ymls.uniq!
+      @locale_ymls.uniq!
+      @catalog_ymls.uniq!
+      @tex_ymls.uniq!
+      @epub_ymls.uniq!
+    end
+
+    def check_old_catalogs(dir)
+      files = Dir.glob(File.join(dir, '*')).map do |fname|
+        if %w[PREDEF CHAPS POSTDEF PART].include?(File.basename(fname))
+          File.basename(fname)
+        else
+          return nil
+        end
+      end.compact
+
+      unless files.empty?
+        @logger.error t("!! %s file(s) is obsoleted. Run 'review-catalog-converter' to convert to 'catalog.yml' and remove old files. Aborted. !!", files.join(', '))
+        raise ApplicationError
+      end
+    end
+
+    def show_version
+      puts t('** review-update updates your project to %s **', ReVIEW::VERSION)
+    end
+
+    def check_own_files(dir)
+      if File.exist?(File.join(dir, 'layouts/layout.tex.erb'))
+        unless confirm('** There is custom layouts/layout.tex.erb file. Updating may break to make PDF until you fix layout.tex.erb. Do you really proceed to update? **', [], nil)
+          raise ApplicationError
+        end
+      end
+
+      if File.exist?(File.join(dir, 'review-ext.rb'))
+        @logger.info t('** There is review-ext.rb file. You need to update it by yourself. **')
+      end
+    end
+
+    def update_version
+      @config_ymls.each do |yml|
+        config = YAML.load_file(yml)
+        if config['review_version'].to_f == TARGET_VERSION.to_f
+          next
+        end
+
+        flag = true
+        if config['review_version'].to_f > TARGET_VERSION.to_f
+          flag = nil
+        end
+
+        if confirm("%s: Update '%s' to '%s'?", [File.basename(yml), 'review_version', TARGET_VERSION], flag)
+          rewrite_yml(yml, 'review_version', TARGET_VERSION)
+        end
+      end
+    end
+
+    def update_rakefile(dir)
+      taskdir = File.join(dir, 'lib/tasks')
+      unless File.exist?(taskdir)
+        FileUtils.mkdir_p taskdir
+      end
+
+      master_rakefile = File.join(@review_dir, 'samples/sample-book/src/Rakefile')
+
+      target_rakefile = File.join(dir, 'Rakefile')
+      if File.exist?(target_rakefile)
+        if Digest::SHA256.hexdigest(File.read(target_rakefile)) != Digest::SHA256.hexdigest(File.read(master_rakefile))
+          if confirm('%s will be overridden with Re:VIEW version (%s). Do you really proceed?', ['Rakefile', master_rakefile])
+            FileUtils.mv target_rakefile, "#{target_rakefile}-old"
+            FileUtils.cp master_rakefile, target_rakefile
+          end
+        end
+      else
+        FileUtils.cp master_rakefile, target_rakefile
+      end
+
+      master_rakefile = File.join(@review_dir, 'samples/sample-book/src/lib/tasks/review.rake')
+      target_rakefile = File.join(taskdir, 'review.rake')
+      if File.exist?(target_rakefile)
+        if Digest::SHA256.hexdigest(File.read(target_rakefile)) != Digest::SHA256.hexdigest(File.read(master_rakefile))
+          if confirm('%s will be overridden with Re:VIEW version (%s). Do you really proceed?', ['lib/tasks/review.rake', master_rakefile])
+            FileUtils.mv target_rakefile, "#{target_rakefile}-old"
+            FileUtils.cp master_rakefile, target_rakefile
+          end
+        end
+      else
+        FileUtils.cp master_rakefile, target_rakefile
+      end
+    end
+
+    def update_epub_version
+      @epub_ymls.each do |yml|
+        config = YAML.load_file(yml)
+        if config['epubversion'].present? && config['epubversion'].to_f < EPUB_VERSION.to_f
+          if confirm("%s: Update '%s' to '%s' from '%s'?", [File.basename(yml), 'epubversion', EPUB_VERSION, config['epubversion']])
+            rewrite_yml(yml, 'epubversion', EPUB_VERSION)
+          end
+        end
+        if !config['htmlversion'].present? || config['htmlversion'].to_f >= HTML_VERSION.to_f
+          next
+        end
+        if confirm("%s: Update '%s' to '%s' from '%s'?", [File.basename(yml), 'htmlversion', HTML_VERSION, config['htmlversion']])
+          rewrite_yml(yml, 'htmlversion', HTML_VERSION)
+        end
+      end
+    end
+
+    def update_locale
+      @locale_ymls.each do |yml|
+        config = YAML.load_file(yml)
+        if !config['chapter_quote'].present? || config['chapter_quote'].scan('%s').size != 1
+          next
+        end
+        v = config['chapter_quote'].sub('%s', '%s %s')
+        if confirm("%s: 'chapter_quote' now takes 2 values. Update '%s' to '%s'?", [File.basename(yml), config['chapter_quote'], v])
+          rewrite_yml(yml, 'chapter_quote', v)
+        end
+      end
+    end
+
+    def update_tex_parameters
+      @tex_ymls.each do |yml|
+        config = YAML.load_file(yml)
+        unless config['texdocumentclass']
+          next
+        end
+
+        if TEX_DOCUMENTCLASS.include?(config['texdocumentclass'][0])
+          if @specified_template.present? && config['texdocumentclass'][0] != @specified_template
+            # want to use other template?
+            @logger.error t("%s: !! 'texdocumentclass' uses new class '%s' already, but you specified '%s'. This tool can't handle such migration. Ignored. !!", [File.basename(yml), config['texdocumentclass'][0], @specified_template])
+            @template = nil
+          end
+          next
+        else
+          @template = config['texdocumentclass'][0]
+        end
+
+        if TEX_DOCUMENTCLASS_BAD.include?(config['texdocumentclass'][0])
+          cno = TEX_DOCUMENTCLASS_BAD.index(config['texdocumentclass'][0])
+
+          if @specified_template && @specified_template != TEX_DOCUMENTCLASS[cno]
+            # not default, manually selected
+            unless confirm("%s: 'texdocumentclass' uses the old class '%s'. By default it is migrated to '%s', but you specify '%s'. Do you really migrate 'texdocumentclass' to '%s'?",
+                           [File.basename(yml), TEX_DOCUMENTCLASS_BAD[cno],
+                            TEX_DOCUMENTCLASS[cno],
+                            @specified_template, @specified_template])
+              @template = nil
+              next
+            end
+            @template = @specified_template
+          else
+            # default migration
+            @template = TEX_DOCUMENTCLASS[cno]
+            unless confirm("%s: 'texdocumentclass' uses the old class '%s'. By default it is migrated to '%s'. Do you really migrate 'texdocumentclass' to '%s'?", [File.basename(yml), TEX_DOCUMENTCLASS_BAD[cno], @template, @template])
+              @template = nil
+              next
+            end
+          end
+
+          flag, modified_opts = convert_documentclass_opts(yml, @template, config['texdocumentclass'][1])
+          if flag # successfully converted
+            @logger.info t("%s: previous 'texdocumentclass' option '%s' is safely replaced with '%s'.", [File.basename(yml), config['texdocumentclass'][1], modified_opts])
+          else # something wrong
+            unless confirm("%s: previous 'texdocumentclass' option '%s' couldn't be converted fully. '%s' is suggested. Do you really proceed?", [File.basename(yml), config['texdocumentclass'][1], modified_opts], nil)
+              @template = nil
+              next
+            end
+          end
+
+          rewrite_yml(yml, 'texdocumentclass', %Q(["#{@template}", "#{modified_opts}"]))
+        else
+          @template = nil
+          @logger.error t("%s: ** 'texdocumentclass' specifies '%s'. Because this is unknown class for this tool, you need to update it by yourself if it won't work. **", [File.basename(yml), config['texdocumentclass']])
+        end
+      end
+    end
+
+    def convert_documentclass_opts(yml, cls, prev_opts)
+      # XXX: at this time, review-jsbook and review-jlreq uses same parameters
+      opts = []
+      flag = true
+      case cls
+      when 'review-jsbook' # at this time, it ignores keyval
+        prev_opts.split(/\s*,\s*/).each do |v|
+          case v
+          when 'a4j', 'a5j', 'b4j', 'b5j', 'a3paper', 'a4paper', 'a5paper', 'a6paper', 'b4paper', 'b5paper', 'b6paper', 'letterpaper', 'legalpaper', 'executivepaper'
+            opts << "paper=#{v.sub('j', '').sub('paper', '')}"
+          when /[\d.]+ptj/ # not cared...
+            q = sprintf('%.2f', v.sub('pt', '').to_f * 1.4056)
+            opts << "Q=#{q}"
+          when /[\d.]+pt/
+            q = sprintf('%.2f', v.sub('pt', '').to_f * 1.4056)
+            opts << "Q=#{q}"
+          when /[\d.]+Q/
+            opts << "Q=#{v.sub('Q', '')}"
+          when 'landscape', 'oneside', 'twoside', 'vartwoside', 'onecolumn',
+               'twocolumn', 'titlepage', 'notitlepage', 'openright',
+               'openany', 'leqno', 'fleqn', 'disablejfam', 'draft', 'final',
+               'mingoth', 'winjis', 'jis', 'papersize', 'english', 'report',
+               'jslogo', 'nojslogo'
+            # pass-through
+            opts << v
+          when 'uplatex', 'nomag', 'usemag', 'nomag*', 'tombow', 'tombo', 'mentuke', 'autodetect-engine'
+            # can be ignored
+            next
+          else
+            flag = nil
+          end
+        end
+        opts << 'cameraready=print'
+        opts << 'cover=false'
+      when 'review-jlreq'
+        # at this time, only think about jsbook->jlreq
+        prev_opts.split(/\s*,\s*/).each do |v|
+          case v
+          when 'a4j', 'a5j', 'b4j', 'b5j', 'a3paper', 'a4paper', 'a5paper', 'a6paper', 'b4paper', 'b5paper', 'b6paper', 'letterpaper', 'legalpaper', 'executivepaper'
+            opts << "paper=#{v.sub('j', '').sub('paper', '')}"
+          when /[\d.]+ptj/ # not cared...
+            opts << "fontsize=#{v.sub('j', '')}"
+          when /[\d.]+pt/
+            opts << "fontsize=#{v}"
+          when /[\d.]+Q/
+            opts << "fontsize=#{v}"
+          when 'landscape', 'oneside', 'twoside', 'onecolumn', 'twocolumn', 'titlepage', 'notitlepage', 'openright', 'openany', 'leqno', 'fleqn', 'draft', 'final', 'report'
+            # pass-through
+            opts << v
+          when 'uplatex', 'nomag', 'usemag', 'nomag*', 'tombow', 'tombo', 'mentuke', 'autodetect-engine'
+            # can be ignored
+            next
+          else
+            # 'vartwoside', 'disablejfam', 'mingoth', 'winjis', 'jis', 'papersize', 'english', 'jslogo', 'nojslogo'
+            flag = nil
+          end
+        end
+        opts << 'cameraready=print'
+        opts << 'cover=false'
+      else
+        flag = nil
+        @logger.error t("%s: ** '%s' is unknown class. Ignored. **", [File.basename(yml), cls])
+      end
+      return flag, opts.join(',')
+    end
+
+    def update_tex_stys(template, dir)
+      texmacrodir = File.join(dir, 'sty')
+      unless File.exist?(texmacrodir)
+        FileUtils.mkdir texmacrodir
+      end
+
+      tdir = File.join(@review_dir, 'templates/latex', template)
+      Dir.glob(File.join(tdir, '*.*')).each do |master_styfile|
+        target_styfile = File.join(texmacrodir, File.basename(master_styfile))
+
+        unless File.exist?(target_styfile)
+          # just copy
+          FileUtils.cp master_styfile, target_styfile
+          next
+        end
+        if File.basename(target_styfile) == 'review-custom.sty'
+          next
+        end
+
+        if Digest::SHA256.hexdigest(File.read(target_styfile)) == Digest::SHA256.hexdigest(File.read(master_styfile))
+          # same
+          next
+        end
+
+        if confirm('%s will be overridden with Re:VIEW version (%s). Do you really proceed?', [target_styfile, master_styfile])
+          FileUtils.mv target_styfile, "#{target_styfile}-old"
+          FileUtils.cp master_styfile, target_styfile
+        end
+      end
+
+      if template == 'review-jsbook'
+        # provide gentombow from vendor/. current version is 2018/08/30 v0.9j
+        unless File.exist?(File.join(texmacrodir, 'gentombow09j.sty'))
+          FileUtils.cp File.join(@review_dir, 'vendor/gentombow/gentombow.sty'), File.join(texmacrodir, 'gentombow09j.sty')
+        end
+      end
+    end
+
+    def update_tex_command
+      @tex_ymls.each do |yml|
+        config = YAML.load_file(yml)
+        if !config['texcommand'] || config['texcommand'] !~ /\s+\-/
+          next
+        end
+        # option should be moved to texoptions
+        cmd, opts = config['texcommand'].split(/\s+\-/, 2)
+        opts = "-#{opts}"
+
+        unless confirm("%s: 'texcommand' has options ('%s'). Move it to 'texoptions'?", [File.basename(yml), opts])
+          next
+        end
+
+        if config['texoptions'].present?
+          config['texoptions'] += " #{opts}"
+          rewrite_yml(yml, 'texcommand', %Q("#{cmd}"))
+          rewrite_yml(yml, 'texoptions', %Q("#{config['texoptions']}"))
+        else
+          rewrite_yml(yml, 'texcommand', %Q("#{cmd}"\ntexoptions: "#{TEX_OPTIONS} #{opts}"))
+        end
+      end
+    end
+
+    def update_dvi_command
+      @tex_ymls.each do |yml|
+        config = YAML.load_file(yml)
+        if !config['dvicommand'] || config['dvicommand'] !~ /\s+\-/
+          next
+        end
+
+        # option should be moved to dvioptions
+        cmd, opts = config['dvicommand'].split(/\s+\-/, 2)
+        opts = "-#{opts}"
+
+        unless confirm("%s: 'dvicommand' has options ('%s'). Move it to 'dvioptions'?", [File.basename(yml), opts])
+          next
+        end
+
+        if config['dvioptions'].present?
+          config['dvioptions'] += " #{opts}"
+          rewrite_yml(yml, 'dvicommand', %Q("#{cmd}"))
+          rewrite_yml(yml, 'dvioptions', %Q("#{config['dvioptions']}"))
+        else
+          rewrite_yml(yml, 'dvicommand', %Q("#{cmd}"\ndvioptions: "#{DVI_OPTIONS} #{opts}"))
+        end
+      end
+    end
+  end
+end