md2site 0.1.2 → 0.1.4

data/lib/md2site/env.rb

@@ -7,18 +7,31 @@ module Md2site
     require "fileutils"
     require "filex"
 
+    # 構成ハッシュ
+    #
+    # @return [Hash] 構成ファイルの変数名をキー、変数の値を値とするハッシュ
     attr_reader :conf_hs
+    # ターゲットコマンド名引きコマンドストラクトハッシュ
+    #
+    # @return [Hash] ターゲットコマンド名をキー、コマンドストラクトを値とするハッシュ
     attr_reader :commands
-    attr_reader :category
-    attr_reader :category_x
+    # ターゲット名引きカテゴリ・ターゲットストラクトハッシュ
+    #
+    # @return [Hash] ターゲット名をキーとして、カテゴリ・ターゲットストラクトを値とするハッシュ
+    attr_reader :category_target
+    # @return [Integer] HTMLファイル名のインデックス
     attr_reader :htmlfile_index
+    # @return [Integer] エイリアスHTMLファイル名のインデックス
     attr_reader :alias_htmlfile_index
+    # @return [String] プロジェクトルートディレクトリの絶対パス
     attr_reader :absolutepath_root
+    # @return [String] サイト固有設定ファイルの絶対パス
     attr_reader :absolutepath_root_settingfile
 
     #
     # 初期化
-    # @param [String] conf_path
+    #
+    # @param conf_path [String] 構成ファイルのパス
     # @param mes [Messagex] Messagexクラスのインスタンス
     # @param verbose [Boolean] FileUtilsクラスのメソッドのverbose引数に与える値
     def initialize(conf_path, mes, verbose)
@@ -26,30 +39,66 @@ module Md2site
       @verbose = verbose
       register_exit_codes
 
-      @category_struct = Struct.new(:target, :misc, :subTargets, :subTargetsByHtmlfile)
+      @envcheck = EnvCheck.new(mes, conf_path)
+
+      # カテゴリ・ターゲットストラクト定義
+      #
+      # カテゴリに含まれるターゲットとサブターゲットを関連付ける
+      # カテゴリはターゲットをまとめるのが役割である。。
+      # ターゲット名は全カテゴリにおいて一意でなければならない。
+      @category_target_struct = Struct.new(:target, :misc, :subTargets, :subTargetsByHtmlfile)
+
+      # ターゲットストラクト定義
+      #
+      # ターゲットはサブターゲットをまとめるのが役割である。
+      # サブターゲットは1個のHTMLを生成するのが役割である。
+      # ターゲットストラクト定義はターゲット向けのものとサブターゲット向けのものとの両方を含んでいて、
+      # ターゲット、サブターゲットのどちらに対しても用いる。
+      #
       @target_struct = Struct.new(:name, :dir, :dataDir, :workDir, :materialDir, :htmldir, :htmlfile, :mdfile, :filedir, :except, :command, :aliashtmldir, :aliashtmlfile, :templates)
+
+      # templateストラクト定義
+      #
+      # YAML形式ファイルまたはMakrdown型式ファイルから、Markdown形式ファイルを生成するために必要な情報を持つ
       @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)
+
+      # ファイルディレクトリストラクト定義
+      #
+      # Makrdown型式ファイルから、HTML形式ファイルを生成するために必要な情報を持つ
+      @filedir_struct = Struct.new(:html_output, :html_input, :partAhtml, :partChtml, :input_md, :output_md, :root_output_md, :data_dir)
+
+      # コマンドストラクト定義
+      #
+      # ターゲットコマンド名、サブターゲットコマンド名からターゲット、サブターゲットを得るための情報を持つ
+      @command_struct = Struct.new(:target, :subtargets)
+
+      # ターゲットコマンド名引きコマンドストラクトハッシュ
       @commands = {}
-      @category = {}
+
+      # ターゲット名引きカテゴリ・ターゲットストラクトハッシュ
+      @category_target = {}
+
+      # 構成ファイル中の変数名をキー都市、変数値を値とする構成ハッシュ
       @conf_hs = {}
 
-      check_conf_path(conf_path)
+      @envcheck.check_conf_path
+      @absolutepath_root = File.dirname(File.dirname(File.absolute_path(conf_path)))
+      @conf_hs["ABSOLUTE_PATH_ROOT"] = @absolutepath_root
       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)
+      check_conf_hs_for_attribute
+      check_conf_hs_and_set
+      check_conf_hs
 
-      @category_x = setup_category(@conf_hs["ABSOLUTE_PATH_SITE_FILE"])
+      setup_category(@sitefile_path)
       setup_config
     end
 
     #
-    # 終了コードの登録
+    # 終了ステータスの登録
     #
-    # rubocop:disable Metrics/MethodLength
-    def register_exit_codes
+    # @return [void]
+    def register_exit_codes # rubocop:disable Metrics/MethodLength
       @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")
@@ -83,189 +132,40 @@ module Md2site
       @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として有効な値が構成ファイル中に指定されているか調べる（無効であればexitする）
     #
-    # 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
+    # @return [void]
+    def check_conf_hs_for_attribute
+      @absolute_path_root_conf, @absolutepath_root_settingfile = @envcheck.check_conf_hs_for_attribute(@conf_hs)
     end
 
     #
-    # 構成ファイルから変換したハッシュに有効な値が指定されているか調べる
-    # @param conf_path [String] 構成ファイルへのパス
+    # 構成ファイルから変換したハッシュに有効な値が指定されているか調べる（無効であればexitする）
     #
-    # 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
+    # @return [void]
+    def check_conf_hs
+      @sitefile_path = @envcheck.check_conf_hs(@conf_hs, @absolutepath_root, @root_output_dir)
     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
+    # 構成ファイルから変換したハッシュに指定されている値が有効であれば、インスタンス変数で参照できるようにする（無効であればexitする）
+    #
+    # @return [void]
+    def check_conf_hs_and_set # rubocop:disable Metrics/MethodLength
+      @category_conf_prefix, @root_output_dir, @src_dir, @data_dir, @work_dir, @material_dir, @target_command_index, @subtarget_command_index, @key_index, @htmlfile_index, @alias_htmlfile_index = @envcheck.check_conf_hs_and_set(@conf_hs)
     end
-    # rubocop:enable Metrics/MethodLength, Style/GuardClause
-
+    
     #
     # 指定ターゲットに属する全サブターゲットコマンド名を得る
+    #
     # @param target_command [String] ターゲットコマンド名
-    # @return [Array] 指定ターゲットに属する全サブターゲットコマンド名の配列
+    # @return [Array<Struct>] 指定ターゲットに属する全サブターゲットコマンド名の配列
     def get_subtarget_commands(target_command)
       if @commands[target_command]
-        if @commands[target_command]["subtargets"]
-          @commands[target_command]["subtargets"].map {|y| y }
+        if @commands[target_command][:subtargets]
+          @commands[target_command][:subtargets].keys
         else
           []
         end
@@ -276,24 +176,27 @@ module Md2site
 
     #
     # ターゲット名、サブターゲット名を指定してサブターゲットストラクト得る
+    #
     # @param target_name [String] ターゲット名
     # @param subtarget_name [String] サブターゲット名
     # @return [Struct] 指定されたサブターゲットストラクト
     def get_sub_target(target_name, subtarget_name)
-      @category[target_name].subTargets[subtarget_name]
+      @category_target[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]
+      @category_target[target_name].subTargetsByHtmlfile[htmlfpath]
     end
 
     #
     # ターゲットコマンド名とサブターゲットコマンド名から、サブターゲットストラクトを得る
+    #
     # @param target_command [String] ターゲットコマンド名
     # @param subtarget_command [String] サブターゲットコマンド名
     # @return [Array] 第0要素　ターゲットストラクト、第1要素 サブターゲットストラクト
@@ -304,28 +207,30 @@ module Md2site
       @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]
+        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']")
+          @mes.output_info("@commands[target_command][:subtargets]")
         end
       else
         @mes.output_info("@commands[target_command]=nil")
-        @mes.output_error("Not specified legal target command")
+        @mes.output_error("Not specified legal target command 1")
         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))
+    # 変数展開 イコールの右辺にある変数名をhash,subhsのどちらかに含まれる、該当変数名をキーとしたハッシュの値に置き換える
+    #
+    # @param value [String] 展開元の変数の値
+    # @param hash [Hash] 置換用ハッシュ
+    # @param subhs [Hash] 第2置換用ハッシュ
+    # @return [String] 展開された変数の値
+    def expand_variable(value, hash, subhs={})
+      @mes.output_debug("value=#{value}")
+      if (m = /(\${([^}]+)})/.match(value))
         pattern = m[1]
         var_name = m[2]
         @mes.output_debug("var_name=#{var_name}")
@@ -334,18 +239,20 @@ module Md2site
         @mes.output_debug("expand=#{expand}")
         expand ||= ENV[var_name]
         if expand
-          var[pattern] = expand
-          expand_variable(var, hash, subhs) if var.index("$")
+          value[pattern] = expand
+          expand_variable(value, hash, subhs) if value.index("$")
         end
       end
-      var
+      value
     end
 
     #
     # 構成ファイルを（変数展開しつつ）ハッシュに変換する
+    #
     # @param conf_fname [String] 構成ファイル名
     # @param hash [Hash] ハッシュ（構成ファイルの内容が追加される）
     # @param subhs [Hash] 第2ハッシュ
+    # @return [void]
     def setup_from_conf(conf_fname, hash, subhs={})
       @mes.exc_file_gets(conf_fname) do
         File.open(conf_fname) do |f|
@@ -354,7 +261,7 @@ module Md2site
             next if /^\s*#/ =~ l
             next if /^\s*$/ =~ l
             if (m = /\s*([^=]+)=([^=]+)\s*$/.match(l))
-              hash[m[1]] = m[2]
+              hash[m[1]] ||= m[2]
             end
           end
         end
@@ -368,7 +275,8 @@ module Md2site
 
     #
     # エイリアス指定をディレクトリ指定と、ファイル名指定に分解する
-    # @param array [Array] カテゴリ別設定ファイルでのパート指定のフィールドの配列
+    #
+    # @param array [Array] カテゴリ別設定ファイルでのサブコンポーネント指定のフィールドの配列
     # @return [Array] 第0要素:エイリアスディレクトリ指定、第1要素:エイリアスファイル名指定
     def normalize_alias_htmlpath(array)
       if array.size >= (@alias_htmlfile_index + 1)
@@ -389,6 +297,7 @@ module Md2site
 
     #
     # HTMLファイル名指定からディレクトリ指定と、ファイル名指定、サブターゲット名、Makrdownファイル名を得る
+    #
     # @param htmlfname [String] HTMLファイル名指定
     # @return [Array] 第0要素:サブターゲット名、第1要素:HTMLファイル名指定、第2要素:HTMLディレクトリ指定、第3要素:Markdownファイル名指定
     def normalize_htmlpath(htmlfname)
@@ -409,39 +318,45 @@ module Md2site
     end
 
     #
-    # 名前引きカテゴリ別構成、コマンド別構成の設定
+    # ターゲット名引きカテゴリ・ターゲットストラクトハッシュ、ターゲットコマンド名引きコマンドストラクトハッシュの設定
+    #  (適切なコマンド名でなければexitする)
+    #
     # @param target_command [String] ターゲットコマンド名
     # @param subtarget_command [String] サブターゲットコマンド名
     # @param stds [String] サブターゲットストラクト
     # @param target [String] ターゲット名
     # @param subtarget [String] サブターゲット名
     # @param htmlfname [String] HTMLファイル名
+    # @return [void]
     def setup_category_oneline_x(target_command, subtarget_command, stds, target, subtarget, htmlfname)
-      @category[target].subTargets[subtarget] = stds
-      @category[target].subTargetsByHtmlfile[htmlfname] = stds
+      # ターゲット名引きカテゴリ・ターゲットストラクトハッシュに、ターゲット名、サブターゲット名に対応するサブターゲットストラクトを設定
+      @category_target[target].subTargets[subtarget] = stds
+      # ターゲット名引きカテゴリ・ターゲットハッシュに、ターゲット名、HTMLファイル名に対応するサブターゲットストラクトを設定
+      @category_target[target].subTargetsByHtmlfile[htmlfname] = stds
 
+      # ターゲットコマンド名引きコマンドストラクトハッシュに、ターゲットコマンド名、サブターゲットコマンド名に対応するサブターゲットストラクトを設定
       if @commands[target_command]
-        if @commands[target_command]["subtargets"]
-          @commands[target_command]["subtargets"][subtarget_command] = stds
+        if @commands[target_command][:subtargets]
+          @commands[target_command][:subtargets][subtarget_command] = stds
         else
-          @mes.output_error("Not specified legal target command")
+          @mes.output_error("Not specified legal target command 2")
           exit(@mes.ec("EXIT_CODE_NOT_SPECIFIED_LEGAL_TARGET_COMMAND"))
         end
       else
-        @mes.output_error("Not specified legal target command")
+        @mes.output_error("Not specified legal target command 3")
         exit(@mes.ec("EXIT_CODE_NOT_SPECIFIED_LEGAL_TARGET_COMMAND"))
       end
     end
 
     #
-    # 名前引きカテゴリ別構成、コマンド別構成の設定
-    # @param fields [Array] カテゴリ別設定ファイルでのパート指定のフィールドの配列
+    # サブコンポーネント指定のフィールドの値からサブターゲットストラクト生成
+    #
+    # @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)
+    # @return [Array] 第0要素: サブターゲットストラクト 第1要素: サブターゲット名 第2要素: HTMLファイル名
+    def setup_category_oneline_sub(fields, target_name, target_command, subtarget_command)
       if fields.size >= (@htmlfile_index + 1)
         htmlfname = fields[@htmlfile_index]
       else
@@ -455,39 +370,36 @@ module Md2site
       misc = fields
       target_dir = File.join(@src_dir, target_name)
 
-      unless @category[target_name]
+      unless @category_target[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, {}, {})
+        @category_target[target_name] = @category_target_struct.new(tds, misc, {}, {})
       end
       unless @commands[target_command]
-        @commands[target_command] ||= { "target" => @category[target_name].target, "subtargets" => {}, "category" => @category[target_name] }
+        @commands[target_command] ||= @command_struct.new(@category_target[target_name].target, {})
       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_name, htmlfname_x, htmldir, mdfname = normalize_htmlpath(htmlfname)
+      subtarget_name_x = subtarget_name.dup
 
-      subtarget_dir = File.join(target_dir, subtarget_name)
+      subtarget_dir = File.join(target_dir, subtarget_name_x)
 
       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]
+      [stds, subtarget_name, htmlfname]
     end
 
     #
-    # カテゴリ別設定ファイルでのパート指定単位での名前引きカテゴリ別構成、コマンド別構成の設定
-    # @param fields [Array] カテゴリ別設定ファイルでのパート指定のフィールドの配列
-    # @param category_x [String] 名前引きカテゴリ別構成
+    # カテゴリ別設定ファイル内の1つのサブコンポーネント指定でのターゲット名引きカテゴリ・ターゲットストラクトハッシュ、
+    #   ターゲットコマンド名引きコマンドストラクトハッシュの設定
+    #
+    # @param fields [Array] サイト固有設定ファイルでのサブカテゴリ指定のフィールドの配列
     # @param file_path [String] カテゴリ別設定ファイルへのパス
-    def setup_category_oneline(fields, category_x, file_path)
-      category_x[:array] << fields
-      category_x[:category] ||= {}
-
+    # @return [void]
+    def setup_category_oneline(fields, file_path)
       target_command = fields[@target_command_index]
       subtarget_command = fields[@subtarget_command_index]
       target_name = fields[@key_index]
@@ -496,18 +408,17 @@ module Md2site
         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)
+      stds, subtarget, htmlfname = setup_category_oneline_sub(fields, target_name, target_command, subtarget_command)
 
       setup_category_oneline_x(target_command, subtarget_command, stds, target_name, subtarget, htmlfname)
     end
 
     #
-    # 名前引きカテゴリ別構成の設定
-    # @param file_path [String] カテゴリ別設定ファイルへのパス
+    # サイト構成ファイルからターゲット名引きカテゴリ・ターゲットストラクトハッシュの設定(無効な指定があればexitする)
+    #
+    # @param file_path [String] サイト構成ファイルへのパス
+    # @return [void]
     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)
@@ -528,49 +439,82 @@ module Md2site
             @mes.output_fatal("Invalid htmlfileIndex(=#{@htmlfile_index})")
             exit(@mes.ec("EXIT_CODE_INVALID_INDEX"))
           end
-          setup_category_oneline(array, category_x, file_path)
+          setup_category_oneline(array, 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
+    # サイト構成ファイルとカテゴリ構成ファイルの検査（異常があればデバッグ用エラーメッセージ出力）
+    #
+    # @param category_target_struct [Struct] 検査対象のカテゴリ・ターゲットストラクト
+    # @param obj [Hash] カテゴリ構成設定ファイル(YAML形式)を変換したハッシュ
+    # @return [void]
+    def check_site_tsv_and_category_conf(category_target_struct, obj)
+      category_subtarget_names = category_target_struct.subTargets.keys
+      target_conf_subtarget_names = obj.keys
+
+      ctkeys = category_subtarget_names - target_conf_subtarget_names
+      unless ctkeys.empty?
+        puts "target name=#{category_target_struct.target.name} category_only=#{ctkeys}"
+      end
+      tckeys = target_conf_subtarget_names - category_subtarget_names
+      unless tckeys.empty?
+        puts "target name=#{category_target_struct.target.name} site_only=#{tckeys}"
+      end
+      puts "==============" unless ctkeys.empty? || tckeys.empty?
+    end
 
+    #
+    # templateストラクトの作成
+    #
+    # @param line [String] サブコンポーネント指定
+    # @param subtarget [Struct] サブターゲットストラクト
+    # @return [Strunct] templateストラクト
+    def make_template_struct(line, subtarget)
+      name, template, misc = line.split(",")
+      macroname = name
+      name_x = name.dup
+      name_x[OUTPUT_DIR] = "" if name_x.index(OUTPUT_DIR)
+
+      outputfname = File.join(subtarget.workDir, %Q(#{name_x}.md))
+
+      src_subtarget_name = nil
+      if template == INCLUDE_INDICATOR
+        kind = :INCLUDE
+        datafname = File.join(misc, %Q(#{name_x}.md))
+        src_subtarget_name = name
+      else
+        kind = :NORMAL
+        datafname = File.join(subtarget.dataDir, %Q(#{name_x}.yml))
+      end
+      @template_struct.new(datafname, template, outputfname, macroname, kind, src_subtarget_name)
+    end
+
+    #
+    # カテゴリ構成ファイルの内容をカテゴリ・ターゲットストラクトに反映する
+    #
+    # @param category_target_struct [Struct] カテゴリ・ターゲットストラクト
+    # @param obj [Hash] カテゴリ構成ファイル(YAML形式)を変換したハッシュ
+    # @return [void]
+    def setup_target_config(category_target_struct, obj)
+      check_site_tsv_and_category_conf(category_target_struct, obj)
+
+      category_target_struct.subTargets.each do |_k, subtarget|
+        subtarget.filedir = @filedir_struct.new(File.join(@root_output_dir, subtarget.htmldir, subtarget.htmlfile).to_s,
+                                                File.join(subtarget.materialDir, subtarget.htmlfile).to_s,
+                                                File.join(subtarget.materialDir, "0.html").to_s,
+                                                File.join(subtarget.materialDir, "2.html").to_s,
+                                                File.join(subtarget.dataDir, subtarget.mdfile).to_s,
+                                                File.join(subtarget.workDir, subtarget.mdfile).to_s,
+                                                File.join(@root_output_dir, subtarget.htmldir, subtarget.mdfile).to_s,
+                                                subtarget.dataDir.to_s)
+        subtarget_name = subtarget.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)
+        obj[subtarget_name].each do |line|
+          subtarget.templates << make_template_struct(line, subtarget)
         end
       end
     end
@@ -578,8 +522,9 @@ module Md2site
     #
     # 全カテゴリに対して、対応するカテゴリ別設定ファイルの内容を反映する
     #
+    # @return [void]
     def setup_config
-      @category.each do |name, category_struct|
+      @category_target.each do |name, category_target_struct|
         target = name
         targetconf_yamlfile = %Q(#{@category_conf_prefix}#{target}.yml)
         targetconf_yamlpath = File.join(@absolute_path_root_conf, targetconf_yamlfile)
@@ -588,10 +533,16 @@ module Md2site
           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)
+        next unless obj
+        setup_target_config(category_target_struct, obj)
       end
     end
 
+    #
+    # パスを絶対パスに変換
+    #
+    # @param path [String,nil] nilでなければ引数pathの絶対パス
+    # @return [String] 絶対パス
     def get_filepath(path)
       if path
         @mes.output_debug("0 path=#{path}")
@@ -608,14 +559,27 @@ module Md2site
       abs_path
     end
 
+    #
+    # makeサブコマンドの指定可能なターゲットコマンド名とサブターゲットコマンド名のオプション指定の組み合わせを返す
+    #
+    # @return [String] makeサブコマンドの指定可能なターゲットコマンド名とサブターゲットコマンド名のオプション指定の組み合わせ
     def make_zlist
-      @commands.map {|t_name, t_hash| t_hash["subtargets"].map {|_, s_hash| %Q(-t #{t_name} -s #{s_hash['command']}) } }.flatten
+      @commands.map {|t_name, command_struct| command_struct[: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>)
+    #
+    # HTMLのアンカータグを生成
+    #
+    # @param subtarget [Struct] サブターゲットストラクト
+    # @return [String] HTMLのアンカータグ
+    def make_anchor_tag(subtarget)
+      %Q(<li><a href="#{subtarget.htmlfile}">#{subtarget.htmlfile}}</a></li>)
     end
 
+    #
+    # HTMLの先頭部分の作成
+    #
+    # @return [String] HTMLの先頭部分
     def make_html_first
       <<~_HTML_HEAD
         <html>
@@ -626,6 +590,10 @@ module Md2site
       _HTML_HEAD
     end
 
+    #
+    # HTMLの末尾部分の作成
+    #
+    # @return [String] HTMLの末尾部分
     def make_html_last
       <<~_HTML_BODY_TAIL
         </ul>
@@ -634,16 +602,20 @@ module Md2site
       _HTML_BODY_TAIL
     end
 
+    #
+    # リンクの一覧のHTMLファイル作成
+    #
+    # @return [void]
     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"))
+        anchors = @commands.map {|_, command_sturct| command_sturct[:subtargets].map {|_, subtarget| make_anchor_tag(subtarget) } }
+        f.puts(anchors.flatten.join("\n"))
         f.puts(make_html_last)
         f.close
       end
     end
   end
-end        
+end