md2site 0.1.2 → 0.1.4

data/lib/md2site/make.rb

@@ -5,6 +5,7 @@ module Md2site
   class Make
     #
     # 初期化
+    #
     # @param env [Env] Envクラスのインスタンス
     # @param mes [Messagex] Messagexクラスのインスタンス
     # @param verbose [Boolean] FileUtilsクラスのメソッドのverbose引数に与える値
@@ -24,8 +25,10 @@ module Md2site
 
     #
     # 引数optionでの指定に従いサブコマンドを実行
+    #
     # @param target_command [String] ターゲットコマンド名
     # @param subtarget_command [String] サブターゲットコマンド名
+    # @return [void]
     def execute_subcommand(target_command, subtarget_command)
       if subtarget_command == SUB_TARGET_COMMAND_OF_ALL
         do_multiple_commands(target_command)
@@ -36,11 +39,13 @@ module Md2site
 
     #
     # 指定ターゲットコマンドに属する全サブターゲットコマンドを順次実行する
+    #
     # @param target_command [String] ターゲットコマンド名
+    # @return [void]
     def do_multiple_commands(target_command)
-      ary = @env.get_subtarget_commands(target_command)
-      if !ary.empty?
-        ary.map do |subtarget_command, _v|
+      subtarget_command_names = @env.get_subtarget_commands(target_command)
+      if !subtarget_command_names.empty?
+        subtarget_command_names.map do |subtarget_command|
           @mes.output_info("#{target_command} #{subtarget_command}")
           do_single_command(target_command, subtarget_command)
         end
@@ -54,8 +59,10 @@ module Md2site
 
     #
     # ターゲットコマンド名、サブターゲットコマンド名の組み合わせを実行する
+    #
     # @param target_command [String] ターゲットコマンド名
     # @param subtarget_command [String] サブターゲットコマンド名
+    # @return [void]
     def do_single_command(target_command, subtarget_command)
       target, subtarget = @env.get_target_and_subtarget(target_command, subtarget_command)
       @mes.output_info(%Q(target=#{target}))
@@ -75,6 +82,7 @@ module Md2site
 
     #
     # 指定パスが有効なファイルであるか調べる
+    #
     # @param fname [String] ファイルのパス
     # @return [Boolean] true:有効なファイルパスである　false:有効なファイルパスでない
     def check_valid_src_file(fname)
@@ -93,8 +101,10 @@ module Md2site
 
     #
     # eRubyスクリプトを用いてMarkdown形式ファイルを生成
+    #
     # @param target_struct [Struct] ターゲットストラクト
     # @param template_struct [Struct] テンプレートストラクト
+    # @return [void]
     def execute_single_command_for_template(target_struct, template_struct)
       # 既存のファイルを読み込む
       if template_struct.kind == :INCLUDE
@@ -114,8 +124,10 @@ module Md2site
 
     #
     # Markdown形式ファイルをeRubyスクリプトを用いて
+    #
     # @param target_struct [Struct] ターゲットストラクト
     # @param subtarget_struct [Struct] サブターゲットストラクト
+    # @return [void]
     def execute_single_command(target_struct, subtarget_struct)
       # 設定されていれば、全テンプレートストラクトに対して、テンプレートを用いてMarkdown形式ファイルを生成
       unless subtarget_struct.templates.empty?
@@ -147,12 +159,13 @@ module Md2site
 
     #
     # サブターゲットでエイリアスが指定されていれば、エイリアスを生成するサブターゲットを得る
+    #
     # @param target_struct [Struct] ターゲットストラクト
     # @param subtarget_struct [Struct] サブターゲットストラクト
     # @return [Struct] 有効なサブターゲットストラクト
     def get_effective_subtarget(target_struct, subtarget_struct)
       if subtarget_struct.aliashtmldir == ""
-        if subtarget_struct.aliashtmlfile == ""
+        if subtarget_struct.aliashtmlfile.empty?
           htmlfpath = nil
         else
           htmlfpath = subtarget_struct.aliashtmlfile
@@ -172,9 +185,11 @@ module Md2site
 
     #
     # 指定されたパートに対応するHTMLファイルパスを得る
+    #
     # @param target_struct [Struct] ターゲットストラクト
     # @param subtarget_struct [Struct] サブターゲットストラクト
     # @param kind [Symbol] :partA パートA :partB パートB
+    # @return [String] 指定されたパートに対応するHTMLファイルパス
     def get_part_html(target_struct, subtarget_struct, kind)
       subtarget_x = get_effective_subtarget(target_struct, subtarget_struct)
 
@@ -189,6 +204,16 @@ module Md2site
       path
     end
 
+    #
+    # Markdown形式ファイルの生成
+    #
+    # @param src_dir [String] 読込元ディレクトリ
+    # @param datafile [String] データファイル名
+    # @param outputfile [String] 出力ファイル名
+    # @param dataop [Symbol] データ操作種類
+    # @param templatefile [String] Markdown形成用eRubyスクリプトファイル名
+    # @param auxhs [Hash] 補助的置換用ハッシュ
+    # @return [void]
     def command_make_md(src_dir, datafile, outputfile, dataop, templatefile, auxhs={})
       @mes.output_info(%Q!command_make_md(#{datafile}, #{outputfile}, #{dataop}, #{templatefile},  #{auxhs}!)
       if src_dir
@@ -196,9 +221,9 @@ module Md2site
         outputfile = File.join(src_dir, outputfile) if outputfile
       end
       optsx = {}
-      optsx["data"] = datafile
-      optsx["output"] = outputfile
-      optsx["dataop"] = dataop
+      optsx[:data] = datafile
+      optsx[:output] = outputfile
+      optsx[:dataop] = dataop
 
       mmt = Mdextab::Makemdtab.new(optsx, @str_variable, @str_static, @obj_by_yaml, @mes)
       if templatefile
@@ -215,6 +240,13 @@ module Md2site
       mmt.post_process
     end
 
+    #
+    # Markdown形式ファイルからHTMLファイルへ変換
+    #
+    # @param inputmd [String] 入力Markdown形式ファイル
+    # @param output_htmlfname [String] 出力HTMLファイル
+    # @return [Boolean] true:成功 false:失敗
+    # @note 変換はpandocを利用するため、pandocがインストールされていることが前提である
     def simple_md2html(inputmd, output_htmlfname)
       @mes.output_info(%Q(pandoc -o #{output_htmlfname} -t html5 #{inputmd}))
       ret = false
@@ -235,29 +267,47 @@ module Md2site
       ret
     end
 
-    def output_html(out_htmlfname, mode, parta, content, partb)
+    #
+    # ３つの部分から1つの完結したHTMLファイルを作成
+    #
+    # @param out_htmlfname [String] 出力HTMLファイル
+    # @param mode [String] 出力ファイルオープン時のモード指定
+    # @param part_a [String] HTMLファイルの先頭部
+    # @param content [String] HTMLファイルの中間部
+    # @param part_b [String] HTMLファイルの末尾部
+    # @return [void]
+    def output_html(out_htmlfname, mode, part_a, content, part_b)
       File.open(out_htmlfname, mode) do |f|
-        f.write(parta)
+        f.write(part_a)
         f.write(content)
-        f.write(partb)
+        f.write(part_b)
       end
     end
 
-    def md2html(root_outputmd, out_htmlfname, parta, partb)
+    #
+    # テーブル拡張Makrdown形式ファイルからら1つの完結したHTMLファイルを作成（ファイルが見つからなかったり、
+    #  出力に失敗すればexitする）
+    #
+    # @param inputmd [String] 入力Makrdown形式ファイル名
+    # @param out_htmlfname [String] 出力HTMLファイル名
+    # @param part_a [String] HTMLファイルの先頭部
+    # @param part_b [String] HTMLファイルの末尾部
+    # @return [void]
+    def md2html(inputmd, out_htmlfname, part_a, part_b)
       tmpdir = File.dirname(out_htmlfname)
       tmpbasename = File.basename(out_htmlfname)
 
       content_htmlfname = File.join(tmpdir, tmpbasename + ".tmp")
-      unless root_outputmd
-        @mes.output_fatal("Can't find file(=#{root_outputmd}")
+      unless inputmd
+        @mes.output_fatal("Can't find file(=#{inputmd}")
         exit(@mes.ec("EXIT_CODE_CANNOT_FIND_FILE"))
       end
-      @mes.output_debug("root_outputmd=#{root_outputmd}")
+      @mes.output_debug("inputmd=#{inputmd}")
       @mes.output_debug("content_htmlfname=#{content_htmlfname}")
-      ret = simple_md2html(root_outputmd, content_htmlfname)
+      ret = simple_md2html(inputmd, content_htmlfname)
       return unless ret
 
-      ret = simple_md2html(root_outputmd, "x.html")
+      ret = simple_md2html(inputmd, "x.html")
       unless ret
         tmpf.close(true)
         return
@@ -266,30 +316,41 @@ module Md2site
       content = ""
       @mes.exc_file_read(content_htmlfname) { content = File.readlines(content_htmlfname).join }
       @mes.output_debug("file_read #{content_htmlfname}")
-#      @mes.output_debug("content #{content}")
-      @mes.exc_file_write(out_htmlfname) { output_html(out_htmlfname, "w", parta, content, partb) }
+      @mes.exc_file_write(out_htmlfname) { output_html(out_htmlfname, "w", part_a, content, part_b) }
       @mes.output_debug("file_write #{out_htmlfname}")
-#      File.unlink(content_htmlfname)
     end
 
-    def command_make_html(src_dir, outputfile_md, root_output_md, parta_html, partc_html, out_htmlfname)
-      @mes.output_info(%Q!command_makehtml(#{outputfile_md}, #{root_output_md}, #{parta_html} #{partc_html} #{out_htmlfname}!)
-      if src_dir
-        outputfile_md = File.join(src_dir, outputfile_md) if outputfile_md
-        root_output_md = File.join(src_dir, root_output_md) if root_output_md
-        parta_html = File.join(src_dir, parta_html) if parta_html
-        partc_html = File.join(src_dir, partc_html) if partc_html
-        out_htmlfname = File.join(src_dir, out_htmlfname) if out_htmlfname
+    #
+    # Markdown形式ファイルの生成
+    #
+    # @param root_dir [String,nil] nilでなければルートディレクトリ
+    # @param inputfile_md [String] テーブル拡張Markdown形式ファイル名
+    # @param root_output_md [String] Markdown形式ファイル名(テーブル拡張をHTMLのTABLEタグに変換したもの)
+    # @param parta_html [String] HTMLファイルの先頭部ファイル
+    # @param partb_html [String] HTMLファイルの末尾部ファイル
+    # @param out_htmlfname [String] データファイル名
+    # @return [void]
+    def command_make_html(root_dir, inputfile_md, root_output_md, parta_html, partb_html, out_htmlfname)
+      @mes.output_info(%Q!command_makehtml(#{inputfile_md}, #{root_output_md}, #{parta_html} #{partb_html} #{out_htmlfname}!)
+      # ルートディレクトリが指定されていれば、引数の全てのファイルのパスを指定ルートディレクトリをその下に置く
+      if root_dir
+        inputfile_md = File.join(root_dir, inputfile_md) if inputfile_md
+        root_output_md = File.join(root_dir, root_output_md) if root_output_md
+        parta_html = File.join(root_dir, parta_html) if parta_html
+        partb_html = File.join(root_dir, partb_html) if partb_html
+        out_htmlfname = File.join(root_dir, out_htmlfname) if out_htmlfname
       end
 
+      # テーブル拡張Markdown形式ファイルからMarkdown形式ファイル(HTMLのTABLEタグに変換)を生成する
       optsx = {}
-      m = Mdextab::Mdextab.new(optsx, outputfile_md, root_output_md, @mes)
+      m = Mdextab::Mdextab.new(optsx, inputfile_md, root_output_md, @mes)
       m.parse(@obj_by_yaml)
       m.post_process
 
+      # Markdown形式ファイルから1個のHTMLファイルを生成
       parta = Filex::Filex.check_and_load_file(parta_html, @mes)
-      partc = Filex::Filex.check_and_load_file(partc_html, @mes)
-      md2html(root_output_md, out_htmlfname, parta, partc)
+      partb = Filex::Filex.check_and_load_file(partb_html, @mes)
+      md2html(root_output_md, out_htmlfname, parta, partb)
     end
   end
-end    
+end

data/lib/md2site/nkfguess.rb

@@ -1,7 +1,15 @@
 module Md2site
+  #
+  # NKF利用のエンコーディング推測モジュール
   module Nkfguess
     require "nkf"
 
+    #
+    # エンコーディング推測
+    #
+    # @param fname [String] エンコーディング推測対象ファイル名
+    # @param mes [Messagex] Messagexクラスのインスタンス
+    # @return [String] "ISO-2022-JP", "eucJP", "CP932", "UTF-8", "ASCII-8BIT"
     def self.guess_file(fname, mes)
       str = nil
       mes.exc_file_read(fname) { File.open(fname) {|f| str = f.gets(nil) } }

data/lib/md2site/setup.rb

@@ -20,13 +20,13 @@ module Md2site
 
     #
     # 初期化
-    # @param env [Env] Envクラスのメソッド
+    #
+    # @param env [Env] 環境クラスのメソッド
     # @param mes [Messagex] Messagexクラスのインスタンス
     def initialize(env, mes)
       @env = env
       @mes = mes
-      @category = @env.category
-      @category_x = @env.category_x
+      @category_target = @env.category_target
       absolute_path_status_file = env.conf_hs["ABSOLUTE_PATH_STATUS_FILE"]
       @url = @env.conf_hs["URL"]
       @res = {}
@@ -36,12 +36,14 @@ module Md2site
       @mes.add_exitcode("EXIT_CODE_CANNOT_FIND_DEST_DIR")
       @mes.add_exitcode("EXIT_CODE_CANNOT_CONVERT_FROM_HTML_TO_MD")
       @mes.add_exitcode("EXIT_CODE_PANDOC_EXIT_ABNORMALLY")
-      @status_file = StatusFile.new(absolute_path_status_file, @url, @mes)
+      @status_file = StatusFile.new(absolute_path_status_file, @env.absolutepath_root, @url, @mes)
     end
 
     #
     # サブコマンド実行
+    #
     # @param option [String] サブコマンドのオプション
+    # @return [void]
     def execute_subcommand(option)
       case option.name
       when "contentUpdate"
@@ -67,6 +69,7 @@ module Md2site
 
     #
     # リモートサイトのファイル取得
+    #
     # @param url [String] 取得先URL
     # @return [Array] 第0要素:Datetime 第1要素:UNIXタイム 第2要素:HTTPボディ
     def get_remote_file(url)
@@ -82,6 +85,7 @@ module Md2site
 
     #
     # HTTPヘッダの指定フィールドの値を文字列とUNITタイムで取得する
+    #
     # @param headers [Hash] HTTPヘッダを表すハッシュ
     # @param key [String] HTTPヘッダのフィールドを指定するキー
     # @return [Array] 第0要素: 指定フィールドの値(String) 第1要素: 指定フィールドの値(UNIXタイム)
@@ -113,6 +117,7 @@ module Md2site
 
     #
     # HTTPヘッダのlast-modifiedフィールドの値を文字列とUNITタイムで取得
+    #
     # @param headers [Hash] HTTPヘッダを表すハッシュ
     # @return [Array] 第0要素: 指定フィールドの値(String) 第1要素: 指定フィールドの値(UNIXタイム)
     def get_modified_in_datetime_from_header(headers)
@@ -121,6 +126,7 @@ module Md2site
 
     #
     # HTTPヘッダのdateフィールドの値を文字列とUNITタイムで取得
+    #
     # @param headers [Hash] HTTPヘッダを表すハッシュ
     # @return [Array] 第0要素: 指定フィールドの値(String) 第1要素: 指定フィールドの値(UNIXタイム)
     def get_date_in_datetime_from_header(headers)
@@ -129,6 +135,7 @@ module Md2site
 
     #
     # HTTPヘッダから時刻を表すlast-modifiedフィールドまたはdateフィールのの値を文字列とUNIXタイムで取得
+    #
     # @param headers [Hash] HTTPヘッダを表すハッシュ
     # @return [Array] 第0要素: 指定フィールドの値(String) 第1要素: 指定フィールドの値(UNIXタイム)
     def get_modified_in_datetime_or_date_in_datetime_from_header(headers)
@@ -141,6 +148,7 @@ module Md2site
 
     #
     # 指定URLのHTTPヘッダから時刻を表すlast-modifiedフィールドまたはdateフィールのの値を文字列とUNIXタイムで取得
+    #
     # @param url [String] HTTPヘッダを取得したいURL
     # @return [Array] 第0要素: 指定フィールドの値(String) 第1要素: 指定フィールドの値(UNIXタイム)
     def get_modified_in_datetime_or_date_in_datetime(url)
@@ -155,6 +163,7 @@ module Md2site
 
     #
     # 時刻を"年月日-時分秒"の形式の文字列にする
+    #
     # @param datetime [Datetime] Datetimeクラスのインスタンス
     # @return [String] "年月日-時分秒"の形式の文字列
     def get_datestring(datetime)
@@ -163,6 +172,7 @@ module Md2site
 
     #
     # 現在時刻をDatetimeクラスのインスタンスと文字列にする
+    #
     # @return [Array] 第0要素: Datetimeクラスのインスタンス 第1要素: "年月日-時分秒"の形式の文字列
     def current_time
       datetime = DateTime.now
@@ -172,6 +182,7 @@ module Md2site
 
     #
     # 指定サイトでダウンロード指定された全URLのHTTPヘッダの時刻を取得して一覧をファイルに保存
+    #
     # @param dir [String] HTTPヘッダ時刻一覧ファイルの保存先ディレクトリ
     # @return [Array] 第0要素: Datetimeクラスのインスタンス 第1要素: "年月日-時分秒"の形式の文字列
     # @note 一覧を保存するファイルのファイル名はsite-年月日-時分秒.tsvである
@@ -183,10 +194,10 @@ module Md2site
 
       @mes.exc_file_write(fpath) do
         File.open(fpath, "w") do |ofile|
-          @category_x[:category].each do |_k, v|
-            v.each do |_k2, v2|
-              filename = v2[@env.htmlfile_index]
-              next if v2[@env.alias_htmlfile_index]
+          @category_target.each do |_k, v|
+            v[:subTargets].each do |_k2, subtarget|
+              filename = subtarget.htmlfile
+              next unless subtarget.aliashtmlfile && !subtarget.aliashtmlfile&.empty?
 
               if %r{/$}.match?(@url)
                 file_url = URI.join(@url, filename)
@@ -197,9 +208,8 @@ module Md2site
               unless ary.all?
                 @mes.output_error("Can't find last-modified header from #{@url}")
               end
-              v2.concat(ary)
 
-              ofile.puts(v2.join("\t"))
+              ofile.puts([file_url].join("\t"))
             end
           end
         end
@@ -212,32 +222,58 @@ module Md2site
 
     #
     # 引数で指定したファイルが書込み可能であるように書込み先ディレクトリを作成
+    #
     # @param dir [String] ディレクトリ
     # @param filename [String] ファイルへのパス（ファイル名のみも可）
-    def prepare_new_write_path(dir, filename)
+    def prepare_new_write_path(dir, filename, postfix=nil)
+      if postfix
+        extname = File.extname(filename)
+        basename = File.basename(filename, extname)
+        new_fname = %Q(#{basename}#{postfix}#{extname})
+      else
+        basename = File.basename(filename)
+        new_fname = basename
+      end
+
       dirname = File.dirname(filename)
       if dirname != "."
         dirpath = File.join(dir, dirname)
         @mes.exc_make_directory(dirpath) { FileUtils.mkdir_p(dirpath) }
-        basename = File.basename(filename)
-        fpath = File.join(dirpath, basename)
+        fpath = File.join(dirpath, new_fname)
       else
-        fpath = File.join(dir, filename)
+        fpath = File.join(dir, new_fname)
       end
+
       fpath
     end
 
-    def get_remote_contents_sub(target_hash, listfile, last_contents_path)
-      target_hash.each do |_, target_def|
-        filename = target_def[@env.htmlfile_index]
-        next if target_def[@env.alias_htmlfile_index]
+    #
+    # 指定サイトでダウンロード指定された全URLのをファイルとして、保存先ディレクトリにダウンロードし、
+    #  ダウンロードステータスファイルを更新
+    #
+    # @param subtarget_hash [Hash] サブターゲット名をキーとしてサブターゲットストラクトを値とするハッシュ
+    # @param listfile [Listfile] ダウンロードファイル一覧ファイル
+    # @param last_contents_path [String]　ダウンロード保存先ディレクトリ
+    # @return [void]
+    def get_remote_contents_subtargets(subtarget_hash, listfile, last_contents_path)
+      subtarget_hash.each do |_, subtarget_struct|
+        #        filename = target_def[@env.htmlfile_index]
+        unless subtarget_struct.htmldir&.empty?
+          filename = File.join(subtarget_struct.htmldir, subtarget_struct.htmlfile)
+        else
+          filename = subtarget_struct.htmlfile
+        end
+        next unless subtarget_struct.aliashtmlfile&.empty?
 
+        # file_urlが'//'とならないようにする
         if %r{/$}.match?(@url)
           file_url = URI.join(@url, filename)
         else
           file_url = URI.join(@url, "/", filename)
         end
+        # file_urlをダウンロードする
         remote_datetime_str, remote_datetime_unixtime, content = get_remote_file(file_url)
+        # ダウンロードできなかった場合はエラーメッセージを表示して、次のサブターゲットのダウンロードに移る
         unless [remote_datetime_str, remote_datetime_unixtime].all?
           @mes.output_error("Can't get content from #{file_url}")
           listfile.add([filename, remote_datetime_str, remote_datetime_unixtime, nil])
@@ -245,8 +281,9 @@ module Md2site
           sleep(ACCESS_WAIT_SEC)
           next
         end
-        fpath = prepare_new_write_path(last_contents_path, filename)
 
+        # ダウンロードした内容をファイルに書き込む
+        fpath = prepare_new_write_path(last_contents_path, filename)
         @mes.exc_file_write(fpath) do
           File.open(fpath, "w") do |ofile|
             if content
@@ -254,10 +291,17 @@ module Md2site
             end
           end
         end
+        # ダウンロードファイル一覧に追加
         listfile.add([filename, remote_datetime_str, remote_datetime_unixtime, Digest::MD5.hexdigest(content)])
       end
     end
 
+    #
+    # 指定サイトでダウンロード指定された全URLのをファイルとして、指定ディレクトリ下にダウンロードし、
+    #  ダウンロードファイル一覧ファイルを作成し、ダウンロードステータスファイルを更新
+    #
+    # @param dir [String] ダウンロードファイルの保存先ディレクトリ
+    # @return [void]
     def get_remote_contents(dir)
       _, datetimestr = current_time
 
@@ -267,15 +311,28 @@ module Md2site
       last_contents_path = File.absolute_path(File.join(dir, datetimestr))
       @mes.exc_make_directory(last_contents_path) { FileUtils.mkdir_p(last_contents_path) }
 
+      # 保存先ディレクトリ内にダウンロードファイル一覧ファイルを作成
       lf = ListFile.new(last_contents_path, @mes)
-      @category_x[:category].each do |_, target_hash|
-        get_remote_contents_sub(target_hash, lf, last_contents_path)
+      @category_target.each do |_, target_struct|
+        # 各ターゲット毎にファイルをダウンロード
+        get_remote_contents_subtargets(target_struct[:subTargets], lf, last_contents_path)
       end
       lf.close
+
+      # ダウンロードステータスファイルを更新
       @status_file.last_contents_path = last_contents_path
       @status_file.update
     end
 
+    #
+    # ダウンロード保存先ディレクトリから指定サブターゲットのHTMLファイルをサブターゲットで
+    #  指定されてディレクトリにコピーし、3分割し、中間部分をMarkdown形式に変換する
+    #
+    # @param subtarget [String] サブターゲットストラクト
+    # @param src_fpath [String] コピー元ファイルパス
+    # @return [void]
+    # @note HTMLファイルからMarkdown形式ファイルへの変換にはpandocを利用するため、pandoc
+    #  がインストールされていることが前提
     def update_htmlfiles_subtarget(subtarget, src_fpath)
       dest_fpath = prepare_new_write_path(@env.absolutepath_root, subtarget.filedir.html_input)
       unless dest_fpath
@@ -304,14 +361,19 @@ module Md2site
         @mes.output_fatal("Can't find file(=#{in_html}")
         exit(@mes.ec("EXIT_CODE_CANNOT_FIND_FILE"))
       end
-      out_md = prepare_new_write_path(@env.absolutepath_root, subtarget.filedir.input_md)
-      simple_html2md(in_html, out_md)
-
-      path = File.join(@env.absolutepath_root, subtarget.workDir)
-      @mes.exc_make_directory(subtarget.workDir) { FileUtils.mkdir_p(path) }
+      out_orig_md = prepare_new_write_path(@env.absolutepath_root, subtarget.filedir.input_md, "_orig")
+      simple_html2md(in_html, out_orig_md)
+      out_md = File.join(@env.absolutepath_root, subtarget.filedir.input_md)
+      @mes.exc_file_copy(out_orig_md, out_md) { FileUtils.cp(out_orig_md, out_md) } unless File.exist?(out_md)
     end
 
+    #
+    # ダウンロードステータスファイルを更新ダウンロード保存先ディレクトリから指定サブターゲットのHTMLファイルをサブターゲットで
+    #  指定されてディレクトリにコピーし、3分割し、中間部分をMarkdown形式に変換する
+    #
+    # @return [void]
     def update_htmlfiles
+      # 有効なダウンロードステータスファイルが存在しなければexitする
       if @status_file.nil? || @status_file.last_contents_path.nil? || @status_file.last_contents_path.empty?
         @mes.output_info("@status_file=#{@status_file}")
         unless @status_file.nil?
@@ -319,8 +381,14 @@ module Md2site
         end
         exit(@mes.ec("EXIT_CODE_EXECUTE_SETUP_BEFORE_UPDATE_HTMLFILES"))
       else
-        @category.each do |_name, category_struct|
+        # 全ターゲットの全サブターゲットのうち、エイリアスHTMLファイルが指定されておらず、かつ未ダウンロード
+        #   のもののみをダウンロードする
+        @category_target.each do |_name, category_struct|
           category_struct.subTargets.each do |_k, v|
+            # エイリアスHTMLファイルが指定されていても、ワークディレクトリは必要なため、ここで作成する
+            path = File.join(@env.absolutepath_root, v.workDir)
+            @mes.exc_make_directory(path) { FileUtils.mkdir_p(path) }
+
             next unless v.aliashtmlfile.empty?
             filename = v.htmlfile
             next if filename.empty?
@@ -336,6 +404,14 @@ module Md2site
       end
     end
 
+    #
+    # HTMLファイルをMarkdown形式に変換する
+    #
+    # @param input_htmlfname [String] 変換元HTMLファイル名
+    # @param outputmd [String] 変換したMakrdown形式ファイル名
+    # @return [void]
+    # @note HTMLファイルからMarkdown形式ファイルへの変換にはpandocを利用するため、pandoc
+    #  がインストールされていることが前提
     def simple_html2md(input_htmlfname, outputmd)
       ret = false
       _, _, s = Open3.capture3(%Q(pandoc -o #{outputmd} -t markdown #{input_htmlfname}))
@@ -355,4 +431,4 @@ module Md2site
       ret
     end
   end
-end    
+end