document headers & config: yaml introduced

- as toml alternative
- both toml & yaml (meta, conf, make) work

1 files changed, 865 insertions, 102 deletions

diff --git a/org/meta_conf_make_meta.org b/org/meta_conf_make_meta.org
index 72814a7..ff1efb9 100644
--- a/org/meta_conf_make_meta.org
+++ b/org/meta_conf_make_meta.org
@@ -210,7 +210,7 @@ struct ConfCompositeMakeInit {
 }
 #+END_SRC
 
-*** conf site local
+*** struct: conf site local
 
 #+name: meta_defaults_template_structs
 #+BEGIN_SRC d
@@ -251,7 +251,7 @@ struct ConfCompositeSiteLocal {
 }
 #+END_SRC
 
-*** composite meta
+*** struct: composite meta
 
 #+name: meta_defaults_template_structs
 #+BEGIN_SRC d
@@ -327,104 +327,804 @@ struct ConfCompositePlus {
 }
 #+END_SRC
 
-*** metadata associative array indexes                             :header:
+*** JSONValue
 
 #+name: meta_defaults_template_structs
 #+BEGIN_SRC d
-static string[] ptr_head_main
-  = [
-    "classify",
-    "creator",
-    "date",
-    "identifier",
-    "links",
-    "make",
-    "original",
-    "notes",
-    "rights",
-    "title"
-  ];
-static string[] ptr_head_sub_classify
-  = [
-    "dewey",
-    "keywords",
-    "loc",
-    "subject",
-    "topic_register"
-  ];
-static string[] ptr_head_sub_creator
-  = [
-    "author",
-    "author_email",
-    "cover",
-    "illustrator",
-    "translator"
-  ];
-static string[] ptr_head_sub_date
-  = [
-    "added_to_site",
-    "available",
-    "created",
-    "issued",
-    "modified",
-    "published",
-    "valid"
-  ];
-static string[] ptr_head_sub_identifier
-  = [
-    "isbn",
-    "oclc",
-    "pg"
-  ];
-/+ make +/
-static string[] ptr_head_sub_make
-  = [
-    "cover_image",
-    "home_button_image",
-    "home_button_text",
-    "footer", "headings",
-    "auto_num_top_at_level", "auto_num_top_lv", "auto_num_depth",
-    "breaks",
-    "substitute",
-    "bold",
-    "italics",
-    "emphasis",
-    "texpdf_font",
-    "css"
-  ];
-static string[] ptr_head_sub_notes
-  = [
-    "abstract",
-    "description"
-  ];
-static string[] ptr_head_sub_original
-  = [
-    "language",
-    "source",
-    "title"
-  ];
-static string[] ptr_head_sub_publisher
-  = [ "name" ];
-static string[] ptr_head_sub_rights
-  = [
-    "copyright",
-    "cover",
-    "illustrations",
-    "license"
-  ];
-static string[] ptr_head_sub_title
-  = [
-    "edition",
-    "full",
-    "language",
-    "main",
-    "note",
-    "sub"
-  ];
 JSONValue config_jsonstr = `{
 }`;
 #+END_SRC
 
+* 1. YAML to DocReformStruct                     :module:conf_make_meta:yaml:
+** 0. module template
+
+#+BEGIN_SRC d :tangle "../src/doc_reform/meta/conf_make_meta_yaml.d"
+/++
+  yaml headers<BR>
+  extract yaml header return struct
++/
+module doc_reform.meta.conf_make_meta_yaml;
+static template contentYAMLtoDocReformStruct() {
+  import
+    std.algorithm,
+    std.array,
+    std.exception,
+    std.regex,
+    std.stdio,
+    std.string,
+    std.traits,
+    std.typecons,
+    std.utf,
+    std.conv : to;
+  import
+    doc_reform.meta.conf_make_meta_structs,
+    doc_reform.meta.defaults,
+    doc_reform.meta.rgx;
+  ConfCompositePlus _struct_composite;
+  auto contentYAMLtoDocReformStruct(C,Y,M)(
+    C _struct_composite,
+    Y _yaml,
+    M _manifest,
+    string _identifier
+  ) {
+    mixin DocReformRgxInit;
+    static auto rgx = Rgx();
+    debug (yaml) {
+      writeln(">> --------------------------- >>");
+    }
+    confCompositeMakeBuild _mk;
+    <<yaml_objects>>
+    return _struct_composite;
+  }
+}
+#+END_SRC
+
+**  make
+
+#+name: yaml_objects
+#+BEGIN_SRC d
+/+ make ------------------------------------------------------------------- +/
+if ("make" in _yaml
+  && _yaml["make"].type.sequence
+) {
+  if (_yaml["make"].type.mapping
+    && _yaml["make"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("bold" in _yaml["make"]
+      && _yaml["make"]["bold"].type.string
+      && _yaml["make"]["bold"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.make_str.bold = _yaml["make"]["bold"].get!string;
+    }
+    if ("breaks" in _yaml["make"]
+      && _yaml["make"]["breaks"].type.string
+      && _yaml["make"]["breaks"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.make_str.breaks = _yaml["make"]["breaks"].get!string;
+    }
+    if ("cover_image" in _yaml["make"]
+      && _yaml["make"]["cover_image"].type.string
+      && _yaml["make"]["cover_image"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.make_str.cover_image = _yaml["make"]["cover_image"].get!string;
+    }
+    if ("css" in _yaml["make"]
+      && _yaml["make"]["css"].type.string
+      && _yaml["make"]["css"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.make_str.css = _yaml["make"]["css"].get!string;
+    }
+    if ("emphasis" in _yaml["make"]
+      && _yaml["make"]["emphasis"].type.string
+      && _yaml["make"]["emphasis"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.make_str.emphasis = _yaml["make"]["emphasis"].get!string;
+    }
+    if ("footer" in _yaml["make"]
+      && _yaml["make"]["footer"].type.string
+      && _yaml["make"]["footer"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      char[][] __match_footer_array
+        = (cast(char[]) _yaml["make"]["footer"].get!string)
+          .split(rgx.make_heading_delimiter);
+      _struct_composite.make_str.footer = __match_footer_array.to!(string[]);
+    }
+    if ("headings" in _yaml["make"]
+      && _yaml["make"]["headings"].type.string
+      && _yaml["make"]["headings"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      char[][] __match_headings_array
+        = (cast(char[]) _yaml["make"]["headings"].get!string)
+          .split(rgx.make_heading_delimiter);
+      _struct_composite.make_str.headings = __match_headings_array.to!(string[]);
+    } else if ("headings" in _yaml["make"]
+      && _yaml["make"]["headings"].type.string
+      && _yaml["make"]["headings"].tag.match(rgx.yaml_tag_is_seq)
+    ) {
+      foreach(string identify_heading_level; _yaml["make"]["headings"]) {
+        _struct_composite.make_str.headings ~= identify_heading_level;
+      }
+    }
+    if ("home_button_image" in _yaml["make"]
+      && _yaml["make"]["home_button_image"].type.string
+      && _yaml["make"]["home_button_image"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      char[][] __match_home_button_image_array
+        = (cast(char[]) _yaml["make"]["home_button_image"].get!string)
+          .split(rgx.make_heading_delimiter);
+      _struct_composite.make_str.home_button_image = __match_home_button_image_array.to!(string[]);
+    }
+    if ("home_button_text" in _yaml["make"]
+      && _yaml["make"]["home_button_text"].type.string
+      && _yaml["make"]["home_button_text"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.make_str.home_button_text = _yaml["make"]["home_button_text"].get!string;
+    }
+    if ("italics" in _yaml["make"]
+      && _yaml["make"]["italics"].type.string
+      && _yaml["make"]["italics"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.make_str.italics = _yaml["make"]["italics"].get!string;
+    }
+    if ("auto_num_top_at_level" in _yaml["make"]
+      && _yaml["make"]["auto_num_top_at_level"].type.string
+      && _yaml["make"]["auto_num_top_at_level"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.make_str.auto_num_top_at_level = _yaml["make"]["auto_num_top_at_level"].get!string;
+      switch (_yaml["make"]["auto_num_top_at_level"].get!string) {
+      case "A":
+        break;
+      case "B": _struct_composite.make_str.auto_num_top_lv = 1;
+        break;
+      case "C": _struct_composite.make_str.auto_num_top_lv = 2;
+        break;
+      case "D": _struct_composite.make_str.auto_num_top_lv = 3;
+        break;
+      case "1": _struct_composite.make_str.auto_num_top_lv = 4;
+        break;
+      case "2": _struct_composite.make_str.auto_num_top_lv = 5;
+        break;
+      case "3": _struct_composite.make_str.auto_num_top_lv = 6;
+        break;
+      case "4": _struct_composite.make_str.auto_num_top_lv = 7;
+        break;
+      default:
+        break;
+      }
+    }
+    if ("auto_num_depth" in _yaml["make"]
+      && _yaml["make"]["auto_num_depth"].type.string
+      && _yaml["make"]["auto_num_depth"].tag.match(rgx.yaml_tag_is_int)
+    ) { // not sure implemented for documents
+      _struct_composite.make_str.auto_num_depth = _yaml["make"]["auto_num_depth"].get!int;
+    } else if ("auto_num_depth" in _yaml["make"]
+      && _yaml["make"]["auto_num_depth"].type.string
+      && _yaml["make"]["auto_num_depth"].tag.match(rgx.yaml_tag_is_str)
+    ) { // not sure implemented for documents
+      _struct_composite.make_str.auto_num_depth = _yaml["make"]["auto_num_depth"].get!int;
+    }
+    if ("texpdf_font" in _yaml["make"]
+      && _yaml["make"]["texpdf_font"].type.string
+    ) {
+      _struct_composite.make_str.texpdf_font = _yaml["make"]["texpdf_font"].get!string;
+    }
+  }
+  _struct_composite.make.bold                     = _mk.bold(_struct_composite.make_str.bold);
+  _struct_composite.make.breaks                   = _mk.breaks(_struct_composite.make_str.breaks);
+  _struct_composite.make.cover_image              = _mk.cover_image(_struct_composite.make_str.cover_image);
+  _struct_composite.make.css                      = _mk.css(_struct_composite.make_str.css);
+  _struct_composite.make.emphasis                 = _mk.emphasis(_struct_composite.make_str.emphasis);
+  _struct_composite.make.footer                   = _mk.footer(_struct_composite.make_str.footer);
+  _struct_composite.make.headings                 = _mk.headings(_struct_composite.make_str.headings);
+  _struct_composite.make.home_button_image        = _mk.home_button_image(_struct_composite.make_str.home_button_image);
+  _struct_composite.make.home_button_text         = _mk.home_button_text(_struct_composite.make_str.home_button_text);
+  _struct_composite.make.italics                  = _mk.italics(_struct_composite.make_str.italics);
+  _struct_composite.make.auto_num_top_at_level    = _mk.auto_num_top_at_level(_struct_composite.make_str.auto_num_top_at_level);
+  _struct_composite.make.auto_num_top_lv          = _mk.auto_num_top_lv(_struct_composite.make_str.auto_num_top_lv);
+  _struct_composite.make.auto_num_depth           = _mk.auto_num_depth(_struct_composite.make_str.auto_num_depth);
+  _struct_composite.make.substitute               = _mk.substitute(_struct_composite.make_str.substitute);
+  _struct_composite.make.texpdf_font              = _mk.texpdf_font(_struct_composite.make_str.texpdf_font);
+}
+
+#+END_SRC
+
+**  conf
+
+#+name: yaml_objects
+#+BEGIN_SRC d
+/+ conf ------------------------------------------------------------------- +/
+if ("webserv" in _yaml
+  && _yaml["webserv"].type.sequence
+) {
+  if (_yaml["webserv"].type.mapping
+    && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("url_root" in _yaml["webserv"]
+      && _yaml["webserv"]["url_root"].type.string
+      && _yaml["webserv"]["url_root"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.webserv_url_doc_root = _yaml["webserv"]["url_root"].get!string;
+      if (auto m = _struct_composite.conf.webserv_url_doc_root.match(rgx.webserv_url_doc_root)) {
+        _struct_composite.conf.webserv_url_domain = m.captures[2].to!string;
+        _struct_composite.conf.webserv_url_doc_path = m.captures[3].to!string;
+      }
+    }
+    if ("images" in _yaml["webserv"]
+      && _yaml["webserv"]["images"].type.string
+      && _yaml["webserv"]["images"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.webserv_images = _yaml["webserv"]["images"].get!string;
+    }
+    if ("cgi" in _yaml["webserv"]
+      && _yaml["webserv"]["cgi"].type.string
+      && _yaml["webserv"]["cgi"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.webserv_cgi = _yaml["webserv"]["cgi"].get!string;
+    }
+    if ("cgi_host" in _yaml["webserv"]
+      && _yaml["webserv"]["cgi_host"].type.string
+      && _yaml["webserv"]["cgi_host"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.webserv_cgi_host = _yaml["webserv"]["cgi_host"].get!string;
+    }
+    if ("cgi_host_path" in _yaml["webserv"]
+      && _yaml["webserv"]["cgi_host_path"].type.string
+      && _yaml["webserv"]["cgi_host_path"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.webserv_cgi_host_path = _yaml["webserv"]["cgi_host_path"].get!string;
+    }
+    if ("cgi_port" in _yaml["webserv"]
+      && _yaml["webserv"]["cgi_port"].type.string
+      && _yaml["webserv"]["cgi_port"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.webserv_cgi_port = _yaml["webserv"]["cgi_port"].get!string;
+    }
+    if ("cgi_user" in _yaml["webserv"]
+      && _yaml["webserv"]["cgi_user"].type.string
+      && _yaml["webserv"]["cgi_user"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.webserv_cgi_user = _yaml["webserv"]["cgi_user"].get!string;
+    }
+    if ("cgi_file_links" in _yaml["webserv"]
+      && _yaml["webserv"]["cgi_file_links"].type.string
+      && _yaml["webserv"]["cgi_file_links"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.webserv_cgi_file_links = _yaml["webserv"]["cgi_file_links"].get!string;
+    }
+  }
+}
+if ("processing" in _yaml
+  && _yaml["processing"].type.sequence
+) {
+  if (_yaml["processing"].type.mapping
+    && _yaml["processing"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("path" in _yaml["processing"]
+      && _yaml["processing"]["path"].type.string
+      && _yaml["processing"]["path"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.processing_path = _yaml["processing"]["path"].get!string;
+    }
+    if ("dir" in _yaml["processing"]
+      && _yaml["processing"]["dir"].type.string
+      && _yaml["processing"]["dir"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.processing_dir = _yaml["processing"]["dir"].get!string;
+    }
+    if ("concord_max" in _yaml["processing"]
+      && _yaml["processing"]["concord_max"].type.string
+      && _yaml["processing"]["concord_max"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.processing_concord_max = _yaml["processing"]["concord_max"].get!string;
+    }
+  }
+}
+if ("flag" in _yaml
+  && _yaml["flag"].type.sequence
+) {
+  if (_yaml["flag"].type.mapping
+    && _yaml["flag"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("act1" in _yaml["flag"]
+      && _yaml["flag"]["act1"].type.string
+      && _yaml["flag"]["act1"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act1 = _yaml["flag"]["act1"].get!string;
+    }
+    if ("act0" in _yaml["flag"]
+      && _yaml["flag"]["act0"].type.string
+      && _yaml["flag"]["act0"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act0 = _yaml["flag"]["act0"].get!string;
+    }
+    if ("act2" in _yaml["flag"]
+      && _yaml["flag"]["act2"].type.string
+      && _yaml["flag"]["act2"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act2 = _yaml["flag"]["act2"].get!string;
+    }
+    if ("act3" in _yaml["flag"]
+      && _yaml["flag"]["act3"].type.string
+      && _yaml["flag"]["act3"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act3 = _yaml["flag"]["act3"].get!string;
+    }
+    if ("act4" in _yaml["flag"]
+      && _yaml["flag"]["act4"].type.string
+      && _yaml["flag"]["act4"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act4 = _yaml["flag"]["act4"].get!string;
+    }
+    if ("act5" in _yaml["flag"]
+      && _yaml["flag"]["act5"].type.string
+      && _yaml["flag"]["act5"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act5 = _yaml["flag"]["act5"].get!string;
+    }
+    if ("act6" in _yaml["flag"]
+      && _yaml["flag"]["act6"].type.string
+      && _yaml["flag"]["act6"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act6 = _yaml["flag"]["act6"].get!string;
+    }
+    if ("act7" in _yaml["flag"]
+      && _yaml["flag"]["act7"].type.string
+      && _yaml["flag"]["act7"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act7 = _yaml["flag"]["act7"].get!string;
+    }
+    if ("act8" in _yaml["flag"]
+      && _yaml["flag"]["act8"].type.string
+      && _yaml["flag"]["act8"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act8 = _yaml["flag"]["act8"].get!string;
+    }
+    if ("act9" in _yaml["flag"]
+      && _yaml["flag"]["act9"].type.string
+      && _yaml["flag"]["act9"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.flag_act9 = _yaml["flag"]["act9"].get!string;
+    }
+  }
+}
+if ("default" in _yaml
+  && _yaml["default"].type.sequence
+) {
+  if (_yaml["default"].type.mapping
+    && _yaml["default"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("papersize" in _yaml["default"]
+      && _yaml["default"]["papersize"].type.string
+      && _yaml["default"]["papersize"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.default_papersize = _yaml["default"]["papersize"].get!string;
+    }
+    if ("text_wrap" in _yaml["default"]
+      && _yaml["default"]["text_wrap"].type.string
+      && _yaml["default"]["text_wrap"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.default_text_wrap = _yaml["default"]["text_wrap"].get!string;
+    }
+    if ("emphasis" in _yaml["default"]
+      && _yaml["default"]["emphasis"].type.string
+      && _yaml["default"]["emphasis"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.default_emphasis = _yaml["default"]["emphasis"].get!string;
+    }
+    if ("language" in _yaml["default"]
+      && _yaml["default"]["language"].type.string
+      && _yaml["default"]["language"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.default_language = _yaml["default"]["language"].get!string;
+    }
+    if ("digest" in _yaml["default"]
+      && _yaml["default"]["digest"].type.string
+      && _yaml["default"]["digest"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.default_digest = _yaml["default"]["digest"].get!string;
+    }
+  }
+}
+if ("search" in _yaml
+  && _yaml["search"].type.sequence
+) {
+  if (_yaml["search"].type.mapping
+    && _yaml["search"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("flag" in _yaml["search"]
+      && _yaml["search"]["flag"].type.string
+      && _yaml["search"]["flag"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.search_flag = _yaml["search"]["flag"].get!string;
+    }
+    if ("action" in _yaml["search"]
+      && _yaml["search"]["action"].type.string
+      && _yaml["search"]["action"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.search_action = _yaml["search"]["action"].get!string;
+    }
+    if ("db" in _yaml["search"]
+      && _yaml["search"]["db"].type.string
+      && _yaml["search"]["db"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.search_db = _yaml["search"]["db"].get!string;
+    }
+    if ("title" in _yaml["search"]
+      && _yaml["search"]["title"].type.string
+      && _yaml["search"]["title"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.conf.search_title = _yaml["search"]["title"].get!string;
+    }
+  }
+}
+#+END_SRC
+
+**  meta
+
+#+name: yaml_objects
+#+BEGIN_SRC d
+/+ meta ------------------------------------------------------------------- +/
+if (_struct_composite.meta.creator_author.empty) {
+  if ("creator" in _yaml
+    && _yaml["creator"].type.sequence
+  ) {
+    if (_yaml["creator"].type.mapping
+      && _yaml["creator"].tag.match(rgx.yaml_tag_is_map)
+    ) {
+      if ("author" in _yaml["creator"]
+        && _yaml["creator"]["author"].type.string
+        && _yaml["creator"]["author"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.creator_author = _yaml["creator"]["author"].get!string;
+      }
+      if ("email" in _yaml["creator"]
+        && _yaml["creator"]["email"].type.string
+        && _yaml["creator"]["email"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.creator_author_email = _yaml["creator"]["email"].get!string;
+      }
+      if ("illustrator" in _yaml["creator"]
+        && _yaml["creator"]["illustrator"].type.string
+        && _yaml["creator"]["illustrator"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.creator_illustrator = _yaml["creator"]["illustrator"].get!string;
+      }
+      if ("translator" in _yaml["creator"]
+        && _yaml["creator"]["translator"].type.string
+        && _yaml["creator"]["translator"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.creator_translator = _yaml["creator"]["translator"].get!string;
+      }
+    } else if (_yaml["creator"].type.string
+      && _yaml["creator"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.creator_author = _yaml["creator"].get!string;
+    }
+  }
+  string[] author_arr;
+  string[][string] authors_hash_arr = [ "first" : [], "last" : [], "full" : [], "last_first" : [], "as_input" : [] ];
+  string[] authors_raw_arr
+    = _struct_composite.meta.creator_author.split(rgx.arr_delimiter);
+  auto _lastname = appender!(char[])();
+  foreach (author_raw; authors_raw_arr) {
+    author_arr                   ~= author_raw.replace(rgx.raw_author_munge, "$2 $1");
+    authors_hash_arr["first"]    ~= author_raw.replace(rgx.raw_author_munge, "$2");
+    authors_hash_arr["last"]     ~= author_raw.replace(rgx.raw_author_munge, "$1");
+    authors_hash_arr["full"]     ~= author_raw.replace(rgx.raw_author_munge, "$2 $1");
+    authors_hash_arr["as_input"] ~= author_raw;
+    if (auto m = author_raw.match(rgx.raw_author_munge)) {
+      (m.captures[1]).map!toUpper.copy(_lastname);
+      authors_hash_arr["last_first"] ~= _lastname.data.to!string ~ ", " ~ m.captures[2];
+      _lastname = appender!(char[])();
+    }
+  }
+  _struct_composite.meta.creator_author_arr = author_arr;
+  _struct_composite.meta.creator_author     = author_arr.join(", ").chomp.chomp;
+  _struct_composite.meta.creator_author_surname = authors_hash_arr["last"][0];
+  string _author_name_last_first = authors_hash_arr["last_first"].join("; ").chomp.chomp;
+  _struct_composite.meta.creator_author_surname_fn = (_author_name_last_first.length > 0)
+  ? _author_name_last_first
+  : authors_hash_arr["as_input"].join("; ").chomp.chomp;
+}
+if (_struct_composite.meta.title_main.empty) {
+  if ("title" in _yaml
+    && _yaml["title"].type.sequence
+  ) {
+    if (_yaml["title"].type.mapping
+      && _yaml["title"].tag.match(rgx.yaml_tag_is_map)
+    ) {
+      if ("main" in _yaml["title"]
+        && _yaml["title"]["main"].type.string
+        && _yaml["title"]["main"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.title_main = _yaml["title"]["main"].get!string;
+      } else if ("title" in _yaml["title"]
+        && _yaml["title"]["title"].type.string
+        && _yaml["title"]["title"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.title_main = _yaml["title"]["title"].get!string;
+      }
+      if ("edition" in _yaml["title"]
+        && _yaml["title"]["edition"].type.string
+        && _yaml["title"]["edition"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.title_edition = _yaml["title"]["edition"].get!string;
+      }
+      if ("full" in _yaml["title"]
+        && _yaml["title"]["full"].type.string
+        && _yaml["title"]["full"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.title_full = _yaml["title"]["full"].get!string;
+      }
+      if ("language" in _yaml["title"]
+        && _yaml["title"]["language"].type.string
+        && _yaml["title"]["language"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.title_language = _yaml["title"]["language"].get!string;
+      }
+      if ("note" in _yaml["title"]
+        && _yaml["title"]["note"].type.string
+        && _yaml["title"]["note"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.title_note = _yaml["title"]["note"].get!string;
+      }
+      if ("subtitle" in _yaml["title"]
+        && _yaml["title"]["subtitle"].type.string
+        && _yaml["title"]["subtitle"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.title_subtitle = _yaml["title"]["subtitle"].get!string;
+      } else if ("sub" in _yaml["title"]
+        && _yaml["title"]["sub"].type.string
+        && _yaml["title"]["sub"].tag.match(rgx.yaml_tag_is_str)
+      ) {
+        _struct_composite.meta.title_subtitle = _yaml["title"]["sub"].get!string;
+      }
+    } else if (
+      _yaml["title"].type.string
+      && _yaml["title"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.title_main = _yaml["title"].get!string;
+    }
+  }
+  _struct_composite.meta.title_sub = _struct_composite.meta.title_subtitle;
+  if ((!(_struct_composite.meta.title_subtitle.empty))
+  && (_struct_composite.meta.title_sub.empty)) {
+    _struct_composite.meta.title_sub = _struct_composite.meta.title_subtitle;
+  }
+  _struct_composite.meta.title_full = (_struct_composite.meta.title_subtitle.empty)
+  ? _struct_composite.meta.title_main
+  : format(
+      "%s - %s",
+      _struct_composite.meta.title_main,
+      _struct_composite.meta.title_subtitle,
+    );
+}
+if ("classify" in _yaml
+  && _yaml["classify"].type.sequence
+) {
+  if (_yaml["classify"].type.mapping
+    && _yaml["classify"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("dewey" in _yaml["classify"]
+      && _yaml["classify"]["dewey"].type.string
+      && _yaml["classify"]["dewey"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.classify_dewey = _yaml["classify"]["dewey"].get!string;
+    }
+    if ("loc" in _yaml["classify"]
+      && _yaml["classify"]["loc"].type.string
+      && _yaml["classify"]["loc"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.classify_loc = _yaml["classify"]["loc"].get!string;
+    }
+    if ("keywords" in _yaml["classify"]
+      && _yaml["classify"]["keywords"].type.string
+      && _yaml["classify"]["keywords"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.classify_keywords = _yaml["classify"]["keywords"].get!string;
+    }
+    if ("topic_register" in _yaml["classify"]
+      && _yaml["classify"]["topic_register"].type.string
+      && _yaml["classify"]["topic_register"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.classify_topic_register = _yaml["classify"]["topic_register"].get!string;
+      string[] main_topics_ = _struct_composite.meta.classify_topic_register.strip.split(rgx.topic_register_main_terms_split);
+      string[] topics;
+      string   topics_tmp;
+      string[] multiple_sub_terms;
+      foreach (mt; main_topics_) {
+        topics_tmp = mt.replaceAll(rgx.topic_register_main_term_plus_rest_split,    mkup.sep);
+        if (auto m = topics_tmp.match(rgx.topic_register_multiple_sub_terms_split)) {
+          multiple_sub_terms = m.captures[1].split(rgx.topic_register_sub_terms_split);
+          foreach (subterm; multiple_sub_terms) {
+            topics ~= m.captures.pre ~ mkup.sep ~ subterm;
+          }
+        } else {
+          topics ~= topics_tmp;
+        }
+      }
+      // writeln("--> ", topics);
+      _struct_composite.meta.classify_topic_register_arr = topics;
+    }
+  }
+}
+if ("date" in _yaml
+  && _yaml["date"].type.sequence
+) {
+  if (_yaml["date"].type.mapping
+    && _yaml["date"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("added_to_site" in _yaml["date"]
+      && _yaml["date"]["added_to_site"].type.string
+      && _yaml["date"]["added_to_site"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.date_added_to_site = _yaml["date"]["added_to_site"].get!string;
+    }
+    if ("available" in _yaml["date"]
+      && _yaml["date"]["available"].type.string
+      && _yaml["date"]["available"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.date_available = _yaml["date"]["available"].get!string;
+    }
+    if ("created" in _yaml["date"]
+      && _yaml["date"]["created"].type.string
+      && _yaml["date"]["created"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.date_created = _yaml["date"]["created"].get!string;
+    }
+    if ("issued" in _yaml["date"]
+      && _yaml["date"]["issued"].type.string
+      && _yaml["date"]["issued"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.date_issued = _yaml["date"]["issued"].get!string;
+    }
+    if ("modified" in _yaml["date"]
+      && _yaml["date"]["modified"].type.string
+      && _yaml["date"]["modified"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.date_modified = _yaml["date"]["modified"].get!string;
+    }
+    if ("published" in _yaml["date"]
+      && _yaml["date"]["published"].type.string
+      && _yaml["date"]["published"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.date_published = _yaml["date"]["published"].get!string;
+    }
+    if ("valid" in _yaml["date"]
+      && _yaml["date"]["valid"].type.string
+      && _yaml["date"]["valid"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.date_valid = _yaml["date"]["valid"].get!string;
+    }
+  }
+}
+_struct_composite.meta.language_document_char = _manifest.src.language; // move
+if ("links" in _yaml) {
+  // if ("" in _yaml["links"]) {
+  //   _struct_composite.meta.links_ = _yaml["links"][""].str;
+  // }
+}
+if ("notes" in _yaml
+  && _yaml["notes"].type.sequence
+) {
+  if (_yaml["notes"].type.mapping
+    && _yaml["notes"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("abstract" in _yaml["notes"]
+      && _yaml["notes"]["abstract"].type.string
+      && _yaml["notes"]["abstract"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.notes_abstract = _yaml["notes"]["abstract"].get!string;
+    }
+    if ("description" in _yaml["notes"]
+      && _yaml["notes"]["description"].type.string
+      && _yaml["notes"]["description"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.notes_description = _yaml["notes"]["description"].get!string;
+    }
+  }
+}
+if ("original" in _yaml
+  && _yaml["original"].type.sequence
+) {
+  if (_yaml["original"].type.mapping
+    && _yaml["original"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("language" in _yaml["original"]
+      && _yaml["original"]["language"].type.string
+      && _yaml["original"]["language"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.original_language = _yaml["original"]["language"].get!string;
+    }
+    if ("language_char" in _yaml["original"]
+      && _yaml["original"]["language_char"].type.string
+      && _yaml["original"]["language_char"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.original_language_char = _yaml["original"]["language_char"].get!string;
+    }
+    if ("source" in _yaml["original"]
+      && _yaml["original"]["source"].type.string
+      && _yaml["original"]["source"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.original_source = _yaml["original"]["source"].get!string;
+    }
+    if ("title" in _yaml["original"]
+      && _yaml["original"]["title"].type.string
+      && _yaml["original"]["title"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.original_title = _yaml["original"]["title"].get!string;
+    }
+  }
+}
+if ("publisher" in _yaml) {
+  // if ("" in _yaml["publisher"]) {
+  //   _struct_composite.meta.publisher = _yaml["publisher"][""].str;
+  // }
+}
+if ("rights" in _yaml
+  && _yaml["rights"].type.sequence
+) {
+  if (_yaml["rights"].type.mapping
+    && _yaml["rights"].tag.match(rgx.yaml_tag_is_map)
+  ) {
+    if ("copyright" in _yaml["rights"]
+      && _yaml["rights"]["copyright"].type.string
+      && _yaml["rights"]["copyright"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.rights_copyright = _yaml["rights"]["copyright"].get!string;
+    }
+    if ("copyright_text" in _yaml["rights"]
+      && _yaml["rights"]["copyright_text"].type.string
+      && _yaml["rights"]["copyright_text"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.rights_copyright_text = _yaml["rights"]["copyright_text"].get!string;
+    }
+    if ("copyright_audio" in _yaml["rights"]
+      && _yaml["rights"]["copyright_audio"].type.string
+      && _yaml["rights"]["copyright_audio"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.rights_copyright_audio = _yaml["rights"]["copyright_audio"].get!string;
+    }
+    if ("copyright_cover" in _yaml["rights"]
+      && _yaml["rights"]["copyright_cover"].type.string
+      && _yaml["rights"]["copyright_cover"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.rights_copyright_cover = _yaml["rights"]["copyright_cover"].get!string;
+    }
+    if ("copyright_illustrations" in _yaml["rights"]
+      && _yaml["rights"]["copyright_illustrations"].type.string
+      && _yaml["rights"]["copyright_illustrations"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.rights_copyright_illustrations = _yaml["rights"]["copyright_illustrations"].get!string;
+    }
+    if ("copyright_photographs" in _yaml["rights"]
+      && _yaml["rights"]["copyright_photographs"].type.string
+      && _yaml["rights"]["copyright_photographs"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.rights_copyright_photographs = _yaml["rights"]["copyright_photographs"].get!string;
+    }
+    if ("copyright_translation" in _yaml["rights"]
+      && _yaml["rights"]["copyright_translation"].type.string
+      && _yaml["rights"]["copyright_translation"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.rights_copyright_translation = _yaml["rights"]["copyright_translation"].get!string;
+    }
+    if ("copyright_video" in _yaml["rights"]
+      && _yaml["rights"]["copyright_video"].type.string
+      && _yaml["rights"]["copyright_video"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.rights_copyright_video = _yaml["rights"]["copyright_video"].get!string;
+    }
+    if ("license" in _yaml["rights"]
+      && _yaml["rights"]["license"].type.string
+      && _yaml["rights"]["license"].tag.match(rgx.yaml_tag_is_str)
+    ) {
+      _struct_composite.meta.rights_license = _yaml["rights"]["license"].get!string;
+    }
+  }
+}
+#+END_SRC
+
 * 1. JSON to DocReformStruct                     :module:conf_make_meta:json:
 ** 0. module template
 
@@ -1095,9 +1795,9 @@ if ("rights" in _json.object) {
   extract native/orig header return associative array<BR>
 
   the header is passed as text (lopped off top of a sisu markup file until the
-  required first heading ^A~), determine whether is a native header or sdlang one
-  with a regex check if whether it contains the "native header" required tag/field
-  @title: then process accordingly as a "native header" or "sdlang header"
+  required first heading ^A~), determine whether is a yaml header or toml one
+  with a regex check if whether it contains the "yaml header" required tag/field
+  title: then process accordingly as a "yaml header" or "toml header"
   converting the metadata and make instructions to a common json format used by
   program internally. Moved to associative array.
 +/
@@ -1119,6 +1819,28 @@ static template configParseTOMLreturnJSON() {
 
 ** 1. parse TOML config to JSON return DocReformStruct
 
+#+BEGIN_SRC d :tangle "../src/doc_reform/meta/conf_make_meta_yaml.d"
+static template configParseYAMLreturnDocReformStruct() {
+  import dyaml;
+  import
+    doc_reform.meta.conf_make_meta_structs,
+    doc_reform.meta.conf_make_meta_json;
+  mixin contentYAMLtoDocReformStruct;
+  auto configParseYAMLreturnDocReformStruct(T,CCm,M)(
+    T       _document_struct,
+    CCm     _make_and_meta_struct,
+    M       _manifest
+  ){
+    Node yaml_root = Loader.fromString(_document_struct.content).load();
+    _make_and_meta_struct
+      = contentYAMLtoDocReformStruct!()(_make_and_meta_struct, yaml_root, _manifest, _document_struct.filename); // struct from yaml
+    return _make_and_meta_struct;
+  }
+}
+#+END_SRC
+
+** 1. parse TOML config to JSON return DocReformStruct
+
 #+BEGIN_SRC d :tangle "../src/doc_reform/meta/conf_make_meta_toml.d"
 static template configParseTOMLreturnDocReformStruct() {
   import
@@ -1165,18 +1887,18 @@ static template docHeaderMakeAndMetaTupTomlExtractAndConvertToStruct() {
   mixin contentJSONtoDocReformStruct;
   static auto rgx = Rgx();
   auto docHeaderMakeAndMetaTupTomlExtractAndConvertToStruct(CCm,Src,M)(
-    CCm     _make_and_meta_struct,
     Src     header_src,
+    CCm     _make_and_meta_struct,
     M       _manifest,
   ) {
-    TOMLDocument _doc;
+    TOMLDocument _doc_toml;
     if (header_src.match(rgx.toml_header_meta_title)) {
       debug (json) {
         writeln(">>> document header is toml, convert to JSON");
       }
-      _doc = parseTOML(cast(string)(header_src));
+      _doc_toml = parseTOML(cast(string)(header_src));
     }
-    auto _doc_json = _doc.toJSON;
+    auto _doc_json = _doc_toml.toJSON;
     auto _header_and_make_and_meta_struct
       = contentJSONtoDocReformStruct!()(_make_and_meta_struct, _doc_json, _manifest, "header");
     return _header_and_make_and_meta_struct;
@@ -1184,15 +1906,56 @@ static template docHeaderMakeAndMetaTupTomlExtractAndConvertToStruct() {
 }
 #+END_SRC
 
+** 2. parse YAML header to +(JSON then)+ Struct
+
+#+BEGIN_SRC d :tangle "../src/doc_reform/meta/conf_make_meta_yaml.d"
+static template docHeaderMakeAndMetaTupYamlExtractAndConvertToStruct() {
+  import
+    std.exception,
+    std.regex,
+    std.stdio,
+    std.traits,
+    std.typecons,
+    std.utf,
+    std.conv : to;
+  import
+    dyaml;
+  import
+    doc_reform.meta.conf_make_meta_structs,
+    doc_reform.meta.conf_make_meta_json,
+    doc_reform.meta.rgx;
+  mixin DocReformRgxInit;
+  mixin contentJSONtoDocReformStruct;
+  static auto rgx = Rgx();
+  auto docHeaderMakeAndMetaTupYamlExtractAndConvertToStruct(CCm,Src,M)(
+    Src     header_src,
+    CCm     _make_and_meta_struct,
+    M       _manifest,
+  ) {
+    Node _yaml_root;
+    if (header_src.match(rgx.yaml_header_meta_title)) {
+      debug (yaml) {
+        writeln(">>> document header is yaml, consider converting to JSON");
+      }
+      import dyaml;
+      _yaml_root = Loader.fromString(header_src).load();
+    }
+    auto _header_and_make_and_meta_struct
+      = contentYAMLtoDocReformStruct!()(_make_and_meta_struct, _yaml_root, _manifest, "header");
+    return _header_and_make_and_meta_struct;
+  }
+}
+#+END_SRC
+
 * __END__
 ** notes headers
 
 #+BEGIN_SRC d
 /+
   /+
-    unify internal representation of header info for native & sdlang document headers
+    unify internal representation of header info for yaml & toml document headers
     represent either using struct, hashes or possibly json
-    doc_reform internal representation should be identical for native & sdlang variants
+    doc_reform internal representation should be identical for yaml & toml variants
   +/
 header.
   ├── make                         // make instructions