md2site 0.1.2

data/lib/md2site/env.rb

@@ -0,0 +1,649 @@
+module Md2site
+  #
+  # 環境クラス
+  #
+  class Env
+    require "yaml"
+    require "fileutils"
+    require "filex"
+
+    attr_reader :conf_hs
+    attr_reader :commands
+    attr_reader :category
+    attr_reader :category_x
+    attr_reader :htmlfile_index
+    attr_reader :alias_htmlfile_index
+    attr_reader :absolutepath_root
+    attr_reader :absolutepath_root_settingfile
+
+    #
+    # 初期化
+    # @param [String] conf_path
+    # @param mes [Messagex] Messagexクラスのインスタンス
+    # @param verbose [Boolean] FileUtilsクラスのメソッドのverbose引数に与える値
+    def initialize(conf_path, mes, verbose)
+      @mes = mes
+      @verbose = verbose
+      register_exit_codes
+
+      @category_struct = Struct.new(:target, :misc, :subTargets, :subTargetsByHtmlfile)
+      @target_struct = Struct.new(:name, :dir, :dataDir, :workDir, :materialDir, :htmldir, :htmlfile, :mdfile, :filedir, :except, :command, :aliashtmldir, :aliashtmlfile, :templates)
+      @template_struct = Struct.new(:datafname, :templatefname, :outputfname, :macroname, :kind, :src_subtarget_name)
+      @filedir = Struct.new(:html_output, :html_input, :partAhtml, :partChtml, :input_md, :output_md, :root_output_md, :data_dir)
+      @commands = {}
+      @category = {}
+      @conf_hs = {}
+
+      check_conf_path(conf_path)
+      setup_from_conf(conf_path, @conf_hs)
+
+      check_conf_hs_for_attribute(conf_path)
+      check_conf_hs_and_set(conf_path)
+      check_conf_hs(conf_path)
+
+      @category_x = setup_category(@conf_hs["ABSOLUTE_PATH_SITE_FILE"])
+      setup_config
+    end
+
+    #
+    # 終了コードの登録
+    #
+    # rubocop:disable Metrics/MethodLength
+    def register_exit_codes
+      @mes.add_exitcode("EXIT_CODE_CANNOT_FIND_CONFFILE")
+      @mes.add_exitcode("EXIT_CODE_NOT_SPECIFIED_CONFFILE")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_ROOT_CONF")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_FIND_ROOTCONFFILE")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_FIND_DEFAULT_TABLE_TEMPLATE")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_ROOT_SETTINGFILE")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_SITE_FILE")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_TEPLATE_DIR")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_CONF_DIR")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_SRC_DIR")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_URL")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_ROOT_TEMPLATE_FUNCTIONS_VARIABLE")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_STATUS_FILE")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_FIND_SITEFILEPATH")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_MAKE_ABSOLUTE_PATH_ROOT")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_TARGET_COMMAND_INDEX")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_SUBTARGET_COMMAND_INDEX")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_KEY_INDEX")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_HTMLFILE_INDEX")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_ALIAS_HTMLFILE_INDEX")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_ROOT")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_CATEGORY_CONF_PREFIX")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_ROOTOUTPUTDIR")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_FIND_ROOTOUTPUTDIR")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_READ_CONFFNAME")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_DATA_DIR")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_WORK_DIR")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_MATERIAL_DIR")
+      @mes.add_exitcode("EXIT_CODE_INVALID_INDEX")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_GET_TARGET")
+      @mes.add_exitcode("EXIT_CODE_CANNOT_FIND_TARGETCONFYAMLPATH")
+      @mes.add_exitcode("EXIT_CODE_NOT_SPECIFIED_LEGAL_TARGET_COMMAND")
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    #
+    # 有効な構成ファイルへのパスであるか調べる
+    # @param conf_path [String] 構成ファイルへのパス
+    def check_conf_path(conf_path)
+      # rubocop:disable Style/GuardClause
+      unless conf_path
+        @mes.output_error("Not specified conf file")
+        exit(@mes.ec("EXIT_CODE_NOT_SPECIFIED_CONFFILE"))
+      end
+
+      unless File.exist?(conf_path)
+        @mes.output_fatal("Cannot find conf file(#{confPath})")
+        exit(@mes.ec("EXIT_CODE_CANNOT_FIND_CONFFILE"))
+      end
+      # rubocop:enable Style/GuardClause
+    end
+
+    #
+    # Envクラスのattributeとして有効な値が構成ファイル中に指定されているか調べる
+    # @param conf_path [String] 構成ファイルへのパス
+    def check_conf_hs_for_attribute(conf_path)
+      # rubocop:disable Style/GuardClause
+      @absolutepath_root = get_filepath(@conf_hs["ABSOLUTE_PATH_ROOT"])
+      if @absolutepath_root.nil?
+        @mes.output_fatal("Cannot get absolutePathRoot from #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_ROOT"))
+      else
+        @mes.exc_make_directory(@absolutepath_root) { FileUtils.mkdir_p(@absolutepath_root, verbose: @verbose) }
+      end
+
+      @absolute_path_root_conf = @conf_hs["ABSOLUTE_PATH_ROOT_CONF"]
+      unless @absolute_path_root_conf
+        @mes.output_fatal("Cannot get ABSOLUTE_PATH_ROOT_CONF in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_ROOT_CONF"))
+      end
+      unless File.exist?(@absolute_path_root_conf)
+        @mes.output_fatal("Cannot find root conf dir(#{@absolute_path_root_conf})")
+        exit(@mes.ec("EXIT_CODE_CANNOT_FIND_ROOTCONFFILE"))
+      end
+
+      @absolutepath_root_settingfile = @conf_hs["ABSOLUTE_PATH_ROOT_SETTINGFILE"]
+      unless @absolutepath_root_settingfile
+        @mes.output_error("Can't get ABSOLUTE_PATH_ROOT_SETTINGFILE in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_ROOT_SETTINGFILE"))
+      end
+      # rubocop:enable Style/GuardClause
+    end
+
+    #
+    # 構成ファイルから変換したハッシュに有効な値が指定されているか調べる
+    # @param conf_path [String] 構成ファイルへのパス
+    #
+    # rubocop:disable Metrics/MethodLength, Style/GuardClause
+    def check_conf_hs(conf_path)
+      default_table_template = @conf_hs["DEFAULT_TABLE_TEMPLATE"] # 5col_no_attr_b.erb
+      unless default_table_template || !FileTest.exist?(default_table_template)
+        @mes.output_fatal("Cannot find valid DEFAULT_TABLE_TEMPLATE(=#{default_table_template}) in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_FIND_DEFAULT_TABLE_TEMPLATE"))
+      end
+
+      sitefile_path = @conf_hs["ABSOLUTE_PATH_SITE_FILE"]
+      unless sitefile_path || !FileTest.exist?(sitefile_path)
+        @mes.output_error("Can't get valid ABSOLUTE_PATH_SITE_FILE in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_SITE_FILE"))
+      end
+
+      absolute_path_status_file = @conf_hs["ABSOLUTE_PATH_STATUS_FILE"]
+      unless absolute_path_status_file || !FileTest.exist?(absolute_path_status_file)
+        @mes.output_error("Can't find valid ABSOLUTE_PATH_STATUS_FILE in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_ABSOLUTE_PATH_STATUS_FILE"))
+      end
+
+      unless @conf_hs["TEMPLELATE_DIR"]
+        @mes.output_error("Can't get TEPLATE_DIR in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_TEPLATE_DIR"))
+      end
+
+      unless @conf_hs["CONF_DIR"]
+        @mes.output_error("Can't get CONF_DIR in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_CONF_DIR"))
+      end
+
+      unless @conf_hs["URL"]
+        @mes.output_error("Can't get URL in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_URL"))
+      end
+
+      unless @conf_hs["ROOT_TEMPLATE_FUNCTIONS_VARIABLE"]
+        @mes.output_fatal("Cannot get value by ROOT_TEMPLATE_FUNCTIONS_VARIABLE from #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_ROOT_TEMPLATE_FUNCTIONS_VARIABLE"))
+      end
+
+      root_output_path = File.join(@absolutepath_root, @root_output_dir)
+      unless File.exist?(root_output_path)
+        @mes.output_error("Can't find root_output_dir(=#{@root_output_dir})")
+        exit(@mes.ec("EXIT_CODE_CANNOT_FIND_ROOTOUTPUTDIR"))
+      end
+    end
+    # rubocop:enable Metrics/MethodLength, Style/GuardClause
+
+    #
+    # 構成ファイルから変換したハッシュに指定されている値が有効であれば、インスタンス変数で参照できるようにする
+    # @param conf_path [String] 構成ファイルへのパス
+    # rubocop:disable Metrics/MethodLength, Style/GuardClause
+    def check_conf_hs_and_set(conf_path)
+      @category_conf_prefix = @conf_hs["CATEGORY_CONF_PREFIX"]
+      unless @category_conf_prefix
+        @mes.output_fatal("Cannot get category conf prefix  from #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_CATEGORY_CONF_PREFIX"))
+      end
+
+      @root_output_dir = @conf_hs["OUTPUT_DIR"]
+      unless @root_output_dir
+        @mes.output_fatal("Cannot get rootOutputDir from #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_ROOTOUTPUTDIR"))
+      end
+
+      @src_dir = @conf_hs["SRC_DIR"]
+      unless @src_dir
+        @mes.output_error("Can't get SRC_DIR in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_SRC_DIR"))
+      end
+
+      @data_dir = @conf_hs["DATA_DIR"]
+      unless @data_dir
+        @mes.output_fatal("Cannot get DATA_DIR in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_DATA_DIR"))
+      end
+
+      @work_dir = @conf_hs["WORK_DIR"]
+      unless @work_dir
+        @mes.output_fatal("Cannot get WORK_DIR in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_WORK_DIR"))
+      end
+
+      @material_dir = @conf_hs["MATERIAL_DIR"]
+      unless @material_dir
+        @mes.output_fatal("Cannot get MATERIAL_DIR in #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_MATERIAL_DIR"))
+      end
+
+      @target_command_index = @conf_hs["TARGET_COMMAND_INDEX"].to_i
+      unless @target_command_index
+        @mes.output_fatal("Cannot get targetCommandIndex from #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_CANNOT_GET_TARGET_COMMAND_INDEX"))
+      end
+
+      @subtarget_command_index = @conf_hs["SUBTARGET_COMMAND_INDEX"].to_i
+      unless @subtarget_command_index
+        @mes.output_fatal("Cannot get subTargetCommandIndex from #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_SUBTARGET_COMMAND_INDEX"))
+      end
+
+      @key_index = @conf_hs["KEY_INDEX"].to_i
+      unless @key_index
+        @mes.output_fatal("Cannot get keyIndex from #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_KEY_INDEX"))
+      end
+
+      @htmlfile_index = @conf_hs["HTMLFILE_INDEX"].to_i
+      unless @htmlfile_index
+        @mes.output_fatal("Cannot get htmlfileIndex from #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_HTMLFILE_INDEX"))
+      end
+
+      @alias_htmlfile_index = @conf_hs["ALIAS_HTMLFILE_INDEX"].to_i
+      unless @alias_htmlfile_index
+        @mes.output_fatal("Cannot get aliasHtmlfileIndex from #{conf_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_ALIAS_HTMLFILE_INDEX"))
+      end
+    end
+    # rubocop:enable Metrics/MethodLength, Style/GuardClause
+
+    #
+    # 指定ターゲットに属する全サブターゲットコマンド名を得る
+    # @param target_command [String] ターゲットコマンド名
+    # @return [Array] 指定ターゲットに属する全サブターゲットコマンド名の配列
+    def get_subtarget_commands(target_command)
+      if @commands[target_command]
+        if @commands[target_command]["subtargets"]
+          @commands[target_command]["subtargets"].map {|y| y }
+        else
+          []
+        end
+      else
+        []
+      end
+    end
+
+    #
+    # ターゲット名、サブターゲット名を指定してサブターゲットストラクト得る
+    # @param target_name [String] ターゲット名
+    # @param subtarget_name [String] サブターゲット名
+    # @return [Struct] 指定されたサブターゲットストラクト
+    def get_sub_target(target_name, subtarget_name)
+      @category[target_name].subTargets[subtarget_name]
+    end
+
+    #
+    # ターゲット名と出力HTMLファイルから、サブターゲットストラクトを得る
+    # @param target_name [String] ターゲット名
+    # @param htmlfpath [String] 出力HTMLファイルへのパス
+    # @return [Struct] 指定されたサブターゲットストラクト
+    def get_subtarget_by_htmlfile(target_name, htmlfpath)
+      @category[target_name].subTargetsByHtmlfile[htmlfpath]
+    end
+
+    #
+    # ターゲットコマンド名とサブターゲットコマンド名から、サブターゲットストラクトを得る
+    # @param target_command [String] ターゲットコマンド名
+    # @param subtarget_command [String] サブターゲットコマンド名
+    # @return [Array] 第0要素　ターゲットストラクト、第1要素 サブターゲットストラクト
+    def get_target_and_subtarget(target_command, subtarget_command)
+      current_target = nil
+      current_subtarget = nil
+      @mes.output_info("Env.get_target_and_subtarget")
+      @mes.output_info("target_command=#{target_command}")
+      @mes.output_info("subtarget_command=#{subtarget_command}")
+      if @commands[target_command]
+        current_target = @commands[target_command]["target"]
+        if @commands[target_command]["subtargets"]
+          current_subtarget = @commands[target_command]["subtargets"][subtarget_command]
+        else
+          @mes.output_info("@commands[target_command]['subtargets']")
+        end
+      else
+        @mes.output_info("@commands[target_command]=nil")
+        @mes.output_error("Not specified legal target command")
+        exit(@mes.ec("EXIT_CODE_NOT_SPECIFIED_LEGAL_TARGET_COMMAND"))
+      end
+      [current_target, current_subtarget]
+    end
+
+    #
+    # 変数展開 イコールの右辺にある変数名をhash,subhsのどちらかに含まれる、該当変数名をキーとした場合の値に置き換える
+    # @param var [String] 変数の値
+    # @param hash [Hash] ハッシュ
+    # @param subhs [Hash] 第2ハッシュ
+    # @return [Array] 展開された変数の値
+    def expand_variable(var, hash, subhs={})
+      if (m = /(\${([^}]+)})/.match(var))
+        pattern = m[1]
+        var_name = m[2]
+        @mes.output_debug("var_name=#{var_name}")
+        expand = hash[var_name]
+        expand ||= subhs[var_name]
+        @mes.output_debug("expand=#{expand}")
+        expand ||= ENV[var_name]
+        if expand
+          var[pattern] = expand
+          expand_variable(var, hash, subhs) if var.index("$")
+        end
+      end
+      var
+    end
+
+    #
+    # 構成ファイルを（変数展開しつつ）ハッシュに変換する
+    # @param conf_fname [String] 構成ファイル名
+    # @param hash [Hash] ハッシュ（構成ファイルの内容が追加される）
+    # @param subhs [Hash] 第2ハッシュ
+    def setup_from_conf(conf_fname, hash, subhs={})
+      @mes.exc_file_gets(conf_fname) do
+        File.open(conf_fname) do |f|
+          while (l = f.gets)
+            l = l.chomp
+            next if /^\s*#/ =~ l
+            next if /^\s*$/ =~ l
+            if (m = /\s*([^=]+)=([^=]+)\s*$/.match(l))
+              hash[m[1]] = m[2]
+            end
+          end
+        end
+      end
+
+      keys = hash.keys
+      keys.each do |key|
+        hash[key] = expand_variable(hash[key], hash, subhs)
+      end
+    end
+
+    #
+    # エイリアス指定をディレクトリ指定と、ファイル名指定に分解する
+    # @param array [Array] カテゴリ別設定ファイルでのパート指定のフィールドの配列
+    # @return [Array] 第0要素:エイリアスディレクトリ指定、第1要素:エイリアスファイル名指定
+    def normalize_alias_htmlpath(array)
+      if array.size >= (@alias_htmlfile_index + 1)
+        alias_htmlfname = array[@alias_htmlfile_index]
+        alias_dir = File.dirname(alias_htmlfname)
+        alias_basename = File.basename(alias_htmlfname, ".html")
+        if alias_dir == "."
+          alias_html_dir = ""
+        end
+        alias_htmlfname_x = [alias_basename, "html"].join(".")
+      else
+        alias_html_dir = ""
+        alias_htmlfname_x = ""
+      end
+
+      [alias_html_dir, alias_htmlfname_x]
+    end
+
+    #
+    # HTMLファイル名指定からディレクトリ指定と、ファイル名指定、サブターゲット名、Makrdownファイル名を得る
+    # @param htmlfname [String] HTMLファイル名指定
+    # @return [Array] 第0要素:サブターゲット名、第1要素:HTMLファイル名指定、第2要素:HTMLディレクトリ指定、第3要素:Markdownファイル名指定
+    def normalize_htmlpath(htmlfname)
+      dir = File.dirname(htmlfname)
+      basename = File.basename(htmlfname)
+      basename_no_ext = File.basename(htmlfname, ".html")
+      if dir == "."
+        subtarget_name = basename_no_ext
+        htmldir = ""
+      else
+        subtarget_name = File.join(dir, basename_no_ext)
+        htmldir = dir
+      end
+      htmlfname_x = basename
+      mdfname = [basename_no_ext, "md"].join(".")
+
+      [subtarget_name, htmlfname_x, htmldir, mdfname]
+    end
+
+    #
+    # 名前引きカテゴリ別構成、コマンド別構成の設定
+    # @param target_command [String] ターゲットコマンド名
+    # @param subtarget_command [String] サブターゲットコマンド名
+    # @param stds [String] サブターゲットストラクト
+    # @param target [String] ターゲット名
+    # @param subtarget [String] サブターゲット名
+    # @param htmlfname [String] HTMLファイル名
+    def setup_category_oneline_x(target_command, subtarget_command, stds, target, subtarget, htmlfname)
+      @category[target].subTargets[subtarget] = stds
+      @category[target].subTargetsByHtmlfile[htmlfname] = stds
+
+      if @commands[target_command]
+        if @commands[target_command]["subtargets"]
+          @commands[target_command]["subtargets"][subtarget_command] = stds
+        else
+          @mes.output_error("Not specified legal target command")
+          exit(@mes.ec("EXIT_CODE_NOT_SPECIFIED_LEGAL_TARGET_COMMAND"))
+        end
+      else
+        @mes.output_error("Not specified legal target command")
+        exit(@mes.ec("EXIT_CODE_NOT_SPECIFIED_LEGAL_TARGET_COMMAND"))
+      end
+    end
+
+    #
+    # 名前引きカテゴリ別構成、コマンド別構成の設定
+    # @param fields [Array] カテゴリ別設定ファイルでのパート指定のフィールドの配列
+    # @param target_name [String] ターゲット名
+    # @param target_command [String] ターゲットコマンド名
+    # @param subtarget_command [String] サブターゲットコマンド名
+    # @param category_x [String] 名前引きカテゴリ別構成
+    # @return [Array] 第0要素: サブターゲット名 第1要素: サブターゲットストラクト 第2要素: HTMLファイル名
+    def setup_category_oneline_sub(fields, target_name, target_command, subtarget_command, category_x)
+      if fields.size >= (@htmlfile_index + 1)
+        htmlfname = fields[@htmlfile_index]
+      else
+        htmlfname = nil
+      end
+      alias_htmldir, alias_htmlfname_x = normalize_alias_htmlpath(fields)
+
+      @mes.output_debug("htmlfname=#{htmlfname}")
+      @mes.output_debug("alias_htmlfname_x=#{alias_htmlfname_x}")
+
+      misc = fields
+      target_dir = File.join(@src_dir, target_name)
+
+      unless @category[target_name]
+        tds = @target_struct.new(target_name, target_dir, nil, nil, nil, nil, nil, nil, nil, nil, target_command, nil, nil, [])
+        @category[target_name] = @category_struct.new(tds, misc, {}, {})
+      end
+      unless @commands[target_command]
+        @commands[target_command] ||= { "target" => @category[target_name].target, "subtargets" => {}, "category" => @category[target_name] }
+      end
+      except = htmlfname.index("/") ? true : false
+
+      subtarget, htmlfname_x, htmldir, mdfname = normalize_htmlpath(htmlfname)
+      subtarget_name = subtarget.dup
+
+      category_x[:category][target_name][subtarget_name] = fields
+
+      subtarget_dir = File.join(target_dir, subtarget_name)
+
+      subtarget_data_dir = File.join(subtarget_dir, @data_dir)
+      subtarget_work_dir = File.join(subtarget_dir, @work_dir)
+      subtarget_material_dir = File.join(subtarget_dir, @material_dir)
+
+      stds = @target_struct.new(subtarget_name, subtarget_dir, subtarget_data_dir, subtarget_work_dir, subtarget_material_dir, htmldir, htmlfname_x, mdfname, nil, except, subtarget_command, alias_htmldir, alias_htmlfname_x, [])
+      [stds, subtarget, htmlfname]
+    end
+
+    #
+    # カテゴリ別設定ファイルでのパート指定単位での名前引きカテゴリ別構成、コマンド別構成の設定
+    # @param fields [Array] カテゴリ別設定ファイルでのパート指定のフィールドの配列
+    # @param category_x [String] 名前引きカテゴリ別構成
+    # @param file_path [String] カテゴリ別設定ファイルへのパス
+    def setup_category_oneline(fields, category_x, file_path)
+      category_x[:array] << fields
+      category_x[:category] ||= {}
+
+      target_command = fields[@target_command_index]
+      subtarget_command = fields[@subtarget_command_index]
+      target_name = fields[@key_index]
+      if target_name.strip.empty?
+        @mes.output_fatal("Cannot get target from #{file_path}")
+        exit(@mes.ec("EXIT_CODE_CANNOT_GET_TARGET"))
+      end
+
+      category_x[:category][target_name] ||= {}
+
+      stds, subtarget, htmlfname = setup_category_oneline_sub(fields, target_name, target_command, subtarget_command, category_x)
+
+      setup_category_oneline_x(target_command, subtarget_command, stds, target_name, subtarget, htmlfname)
+    end
+
+    #
+    # 名前引きカテゴリ別構成の設定
+    # @param file_path [String] カテゴリ別設定ファイルへのパス
+    def setup_category(file_path)
+      category_x = { array: [], category: {} }
+      @mes.exc_file_gets(file_path) do
+        f = File.open(file_path)
+        while (l = f.gets)
+          l.chomp!
+          next if /^#/.match?(l)
+          next if l.strip.empty?
+          array = l.split("\t")
+          size = array.size
+          if @target_command_index >= size
+            @mes.output_fatal("Invalid targetCommandIndex(=#{@target_command_index})")
+            exit(@mes.ec("EXIT_CODE_INVALID_INDEX"))
+          end
+          if @subtarget_command_index >= size
+            @mes.output_fatal("Invalid subTargetCommandIndex(=#{@subtarget_command_index})")
+            exit(@mes.ec("EXIT_CODE_INVALID_INDEX"))
+          end
+          if @htmlfile_index >= size
+            @mes.output_fatal("Invalid htmlfileIndex(=#{@htmlfile_index})")
+            exit(@mes.ec("EXIT_CODE_INVALID_INDEX"))
+          end
+          setup_category_oneline(array, category_x, file_path)
+        end
+        f.close
+      end
+      category_x
+    end
+
+    #
+    # カテゴリ別設定ファイルの内容をカテゴリストラクトに反映する
+    # @param category_struct [Struct] カテゴリストラクト
+    # @param obj [Hash] カテゴリ別設定ファイル(YAML形式)を変換したハッシュ
+    def setup_target_config(category_struct, obj)
+      category_struct.subTargets.each do |_k, v|
+        v.filedir = @filedir.new(File.join(@root_output_dir, v.htmldir, v.htmlfile).to_s,
+                                 File.join(v.materialDir, v.htmlfile).to_s,
+                                 File.join(v.materialDir, "0.html").to_s,
+                                 File.join(v.materialDir, "2.html").to_s,
+                                 File.join(v.dataDir, v.mdfile).to_s,
+                                 File.join(v.workDir, v.mdfile).to_s,
+                                 File.join(@root_output_dir, v.htmldir, v.mdfile).to_s,
+                                 v.dataDir.to_s)
+        subtarget_name = v.name
+
+        next unless obj && obj[subtarget_name]
+
+        obj[subtarget_name].each do |x|
+          name, template, misc = x.split(",")
+          macroname = name
+          x2 = name.dup
+          x2[OUTPUT_DIR] = "" if x2.index(OUTPUT_DIR)
+
+          outputfname = File.join(v.workDir, %Q(#{x2}.md))
+
+          src_subtarget_name = nil
+          if template == INCLUDE_INDICATOR
+            kind = :INCLUDE
+            datafname = File.join(misc, %Q(#{x2}.md))
+            src_subtarget_name = name
+          else
+            kind = :NORMAL
+            datafname = File.join(v.dataDir, %Q(#{x2}.yml))
+          end
+          v.templates << @template_struct.new(datafname, template, outputfname, macroname, kind, src_subtarget_name)
+        end
+      end
+    end
+
+    #
+    # 全カテゴリに対して、対応するカテゴリ別設定ファイルの内容を反映する
+    #
+    def setup_config
+      @category.each do |name, category_struct|
+        target = name
+        targetconf_yamlfile = %Q(#{@category_conf_prefix}#{target}.yml)
+        targetconf_yamlpath = File.join(@absolute_path_root_conf, targetconf_yamlfile)
+        unless File.exist?(targetconf_yamlpath)
+          @mes.output_error("Can't find targetconf_yamlpath(=#{targetconf_yamlpath})")
+          exit(@mes.ec("EXIT_CODE_CANNOT_FIND_TARGETCONFYAMLPATH"))
+        end
+        obj = Filex::Filex.check_and_load_yamlfile(targetconf_yamlpath, @mes)
+        setup_target_config(category_struct, obj)
+      end
+    end
+
+    def get_filepath(path)
+      if path
+        @mes.output_debug("0 path=#{path}")
+        if File.exist?(path)
+          abs_path = File.expand_path(path)
+          @mes.output_debug("1 absPath=#{abs_path}")
+        else
+          abs_path = nil
+        end
+      else
+        abs_path = nil
+        @mes.output_debug("4 absPath=#{abs_path}")
+      end
+      abs_path
+    end
+
+    def make_zlist
+      @commands.map {|t_name, t_hash| t_hash["subtargets"].map {|_, s_hash| %Q(-t #{t_name} -s #{s_hash['command']}) } }.flatten
+    end
+
+    def make_anchar_tag(hash)
+      %Q(<li><a href="#{hash['htmlfile']}">#{hash['htmlfile']}</a></li>)
+    end
+
+    def make_html_first
+      <<~_HTML_HEAD
+        <html>
+        <head>
+        </head>
+        <body>
+        <ul>
+      _HTML_HEAD
+    end
+
+    def make_html_last
+      <<~_HTML_BODY_TAIL
+        </ul>
+        </body>
+        </html>
+      _HTML_BODY_TAIL
+    end
+
+    def make_zindex_html
+      fname = File.join(@absolutepath_root, @root_output_dir, ZINDEX_HTML_FILE)
+      @mes.exc_file_write(fname) do
+        f = File.open(fname, "w")
+        f.puts(make_html_first)
+        anchars = @commands.map {|_, t_hash| t_hash["subtargets"].map {|_, s_hash| make_anchar_tag(s_hash) } }
+        f.puts(anchars.flatten.join("\n"))
+        f.puts(make_html_last)
+        f.close
+      end
+    end
+  end
+end