/+
- Name: Spine, Doc Reform [a part of]
  - Description: documents, structuring, processing, publishing, search
    - static content generator

  - Author: Ralph Amissah
    [ralph.amissah@gmail.com]

  - Copyright: (C) 2015 - 2022 Ralph Amissah, All Rights
    Reserved.

  - License: AGPL 3 or later:

    Spine (SiSU), a framework for document structuring, publishing and
    search

    Copyright (C) Ralph Amissah

    This program is free software: you can redistribute it and/or modify it
    under the terms of the GNU AFERO General Public License as published by the
    Free Software Foundation, either version 3 of the License, or (at your
    option) any later version.

    This program is distributed in the hope that it will be useful, but WITHOUT
    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
    more details.

    You should have received a copy of the GNU General Public License along with
    this program. If not, see [https://www.gnu.org/licenses/].

    If you have Internet connection, the latest version of the AGPL should be
    available at these locations:
    [https://www.fsf.org/licensing/licenses/agpl.html]
    [https://www.gnu.org/licenses/agpl.html]

  - Spine (by Doc Reform, related to SiSU) uses standard:
    - docReform markup syntax
      - standard SiSU markup syntax with modified headers and minor modifications
    - docReform object numbering
      - standard SiSU object citation numbering & system

  - Homepages:
    [https://www.doc_reform.org]
    [https://www.sisudoc.org]

  - Git
    [https://git.sisudoc.org/projects/?p=software/spine.git;a=summary]

+/
/++
  yaml headers<BR>
  extract yaml header return struct
+/
module doc_reform.meta.conf_make_meta_yaml;
template contentYAMLtoSpineStruct() {
  import
    std.algorithm,
    std.array,
    std.exception,
    std.path,
    std.regex,
    std.stdio,
    std.string,
    std.typecons,
    std.utf,
    std.conv : to;
  import
    doc_reform.meta.conf_make_meta_structs,
    doc_reform.meta.defaults,
    doc_reform.meta.rgx;
  ConfComposite _struct_composite;
  @system auto contentYAMLtoSpineStruct(C,Y,M,O,Cfg)(
    C      _struct_composite,
    Y      _yaml,
    M      _manifested,
    O      _opt_action,
    Cfg    _cfg,
    string _identifier
  ) {
    mixin spineRgxIn;
    static auto rgx = RgxI();
    string check_input_markup()(
      string _txt,
    ) {
      _txt = _txt
       .replaceAll(regex(r"\\"), mkup.br_line_inline)
       .strip;
      return _txt;
    }
    confCompositeMakeBuild _mk;
    if (_identifier != "header") { // called only once per run anyway
      /+ conf ------------------------------------------------------------------- +/
      /+
       _cfg. build defaults (else program runtime defaults)
       local_site_configuration defaults
       command line overrides
      +/
      {
        if (_opt_action.webserver_http.length > 0) {
          _struct_composite.conf.w_srv_http
            = _opt_action.webserver_http;
        } else {
          _struct_composite.conf.w_srv_http
            = (_cfg.http_request_type.empty)
              ? "http"
              : _cfg.http_request_type;
          if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
            && (_yaml["webserv"].type.mapping
              && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
          ) {
            if ("http" in _yaml["webserv"]
              && _yaml["webserv"]["http"].type.string
              && _yaml["webserv"]["http"].tag.match(rgx.yaml_tag_is_str)
            ) {
              _struct_composite.conf.w_srv_http
                = _yaml["webserv"]["http"].get!string;
            }
          }
        }
        if (_opt_action.cgi_search_title.length > 0) {
          _struct_composite.conf.w_srv_cgi_search_form_title
            = _opt_action.cgi_search_title;
        } else {
          _struct_composite.conf.w_srv_cgi_search_form_title
            = (_cfg.cgi_search_form_title.empty)
              ? "≅ SiSU spine search form"
              : _cfg.cgi_search_form_title;
          if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
            && (_yaml["webserv"].type.mapping
              && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
          ) {
            if ("cgi_search_form_title" in _yaml["webserv"]
              && _yaml["webserv"]["cgi_search_form_title"].type.string
              && _yaml["webserv"]["cgi_search_form_title"].tag.match(rgx.yaml_tag_is_str)
            ) {
              _struct_composite.conf.w_srv_cgi_search_form_title
                = _yaml["webserv"]["cgi_search_form_title"].get!string;
            }
          }
        }
        if (_opt_action.cgi_sqlite_search_filename.length > 0) {
          _struct_composite.conf.w_srv_cgi_search_script
            = _opt_action.cgi_sqlite_search_filename;
        } else {
          _struct_composite.conf.w_srv_cgi_search_script
            = (_cfg.cgi_filename.empty)
              ? "spine_search"
              : _cfg.cgi_filename;
          if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
            && (_yaml["webserv"].type.mapping
              && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
          ) {
            if ("cgi_search_script" in _yaml["webserv"]
              && _yaml["webserv"]["cgi_search_script"].type.string
              && _yaml["webserv"]["cgi_search_script"].tag.match(rgx.yaml_tag_is_str)
            ) {
              _struct_composite.conf.w_srv_cgi_search_script
                = _yaml["webserv"]["cgi_search_script"].get!string;
            }
          }
        }
        if (_opt_action.sqliteDB_filename.length > 0) {
          _struct_composite.conf.w_srv_db_sqlite_filename
            = _opt_action.sqliteDB_filename;
        } else {
          _struct_composite.conf.w_srv_db_sqlite_filename
            = (_cfg.db_sqlite_filename.empty)
              ?  "spine.search.db"
              : _cfg.db_sqlite_filename;
          if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
            && (_yaml["webserv"].type.mapping
              && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
          ) {
            if ("db_sqlite_filename" in _yaml["webserv"]
              && _yaml["webserv"]["db_sqlite_filename"].type.string
              && _yaml["webserv"]["db_sqlite_filename"].tag.match(rgx.yaml_tag_is_str)
            ) {
              _struct_composite.conf.w_srv_db_sqlite_filename
                = _yaml["webserv"]["db_sqlite_filename"].get!string;
            }
          }
        }
        if (_opt_action.sqliteDB_path.length > 0) {
          _struct_composite.conf.w_srv_db_sqlite_path
            = _opt_action.sqliteDB_path;
        } else {
          _struct_composite.conf.w_srv_db_sqlite_path
            = (_cfg.db_sqlite_path.empty)
              ?  "/var/www/sqlite"
              : _cfg.db_sqlite_path;
          if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
            && (_yaml["webserv"].type.mapping
              && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
          ) {
            if ("db_sqlite_path" in _yaml["webserv"]
              && _yaml["webserv"]["db_sqlite_path"].type.string
              && _yaml["webserv"]["db_sqlite_path"].tag.match(rgx.yaml_tag_is_str)
            ) {
              _struct_composite.conf.w_srv_db_sqlite_path
                = _yaml["webserv"]["db_sqlite_path"].get!string;
            }
          }
        }
        if (_opt_action.cgi_url_action.length > 0) {
          _struct_composite.conf.w_srv_cgi_action
            = _opt_action.cgi_url_action;
        } else {
          _struct_composite.conf.w_srv_cgi_action
            = (_cfg.www_url_doc_root.empty)
              ?  "http://locahost" // "https://sisudoc.org"
              : _cfg.www_url_doc_root;
          if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
            && (_yaml["webserv"].type.mapping
              && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
          ) {
            if ("cgi_action" in _yaml["webserv"]
              && _yaml["webserv"]["cgi_action"].type.string
              && _yaml["webserv"]["cgi_action"].tag.match(rgx.yaml_tag_is_str)
            ) {
              _struct_composite.conf.w_srv_cgi_action
                = _yaml["webserv"]["cgi_action"].get!string;
            } else if (_opt_action.cgi_sqlite_search_filename.length > 0) {
              _struct_composite.conf.w_srv_cgi_action
                = _struct_composite.conf.w_srv_cgi_bin_url ~ "/" ~ _opt_action.cgi_sqlite_search_filename;
            }
          }
        }
        if (!(_struct_composite.conf.output_path)) {
          _struct_composite.conf.output_path = ((_manifested.output.path).asNormalizedPath).array;
        } {
          if (_opt_action.output_dir_set.length > 0) {
            _struct_composite.conf.output_path
              = (_opt_action.output_dir_set.asNormalizedPath).array;
          } else {
            _struct_composite.conf.output_path
              = (_cfg.processing_path_doc_root.empty)
                ?  "/srv/www/spine"
                : _cfg.processing_path_doc_root;
            if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
              && (_yaml["webserv"].type.mapping
                && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
            ) {
              if (_yaml["output"].type.mapping
                && _yaml["output"].tag.match(rgx.yaml_tag_is_map)
              ) {
                if ("path" in _yaml["output"]
                  && _yaml["output"]["path"].type.string
                  && _yaml["output"]["path"].tag.match(rgx.yaml_tag_is_str)
                ) {
                  if (_manifested.output.path == _manifested.env.pwd
                    && _yaml["output"]["path"].get!string.length > 0
                  ) {
                    _struct_composite.conf.output_path = (((_yaml["output"]["path"].get!string).expandTilde).asNormalizedPath).array;
                  }
                }
              }
            }
          }
          if (_opt_action.webserver_host_doc_root.length > 0) { // same as output_path immediately above, resolve FIX REMOVE
            _struct_composite.conf.w_srv_data_root_path
              = _opt_action.webserver_host_doc_root;
          } else {
            _struct_composite.conf.w_srv_data_root_path
              = (_cfg.processing_path_doc_root.empty)
                ? "/var/www/spine"
                : _cfg.processing_path_doc_root;
            if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
              && (_yaml["webserv"].type.mapping
                && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
            ) {
              if ("data_root_path" in _yaml["webserv"]
                && _yaml["webserv"]["data_root_path"].type.string
                && _yaml["webserv"]["data_root_path"].tag.match(rgx.yaml_tag_is_str)
              ) {
                _struct_composite.conf.w_srv_data_root_path
                  = _yaml["webserv"]["data_root_path"].get!string;
              }
            }
          }
        }
        if (_opt_action.cgi_bin_root.length > 0) {
          _struct_composite.conf.w_srv_cgi_bin_path
            = _opt_action.cgi_bin_root;
        } else {
          _struct_composite.conf.w_srv_cgi_bin_path
            = (_cfg.cgi_bin_root.empty)
              ? "/var/www/cgi/cgi-bin"
              : _cfg.cgi_bin_root;
          if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
            && (_yaml["webserv"].type.mapping
              && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
          ) {
            if ("cgi_bin_path" in _yaml["webserv"]
              && _yaml["webserv"]["cgi_bin_path"].type.string
              && _yaml["webserv"]["cgi_bin_path"].tag.match(rgx.yaml_tag_is_str)
            ) {
              _struct_composite.conf.w_srv_cgi_bin_path
                = _yaml["webserv"]["cgi_bin_path"].get!string;
            }
          }
        }
        { _struct_composite.conf.w_srv_data_root_part
            = "";
          if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
            && (_yaml["webserv"].type.mapping
              && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
          ) {
            if ("data_root_part" in _yaml["webserv"]
              && _yaml["webserv"]["data_root_part"].type.string
              && _yaml["webserv"]["data_root_part"].tag.match(rgx.yaml_tag_is_str)
            ) {
              _struct_composite.conf.w_srv_data_root_part = _yaml["webserv"]["data_root_part"].get!string;
            }
          }
        }
        { _struct_composite.conf.w_srv_images_root_part
            = "image";
          if (("webserv" in _yaml && _yaml["webserv"].type.sequence)
            && (_yaml["webserv"].type.mapping
              && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
          ) {
            if ("images_root_part" in _yaml["webserv"]
              && _yaml["webserv"]["images_root_part"].type.string
              && _yaml["webserv"]["images_root_part"].tag.match(rgx.yaml_tag_is_str)
            ) {
              _struct_composite.conf.w_srv_images_root_part = _yaml["webserv"]["images_root_part"].get!string;
            }
          }
        }
      }
      if (("webserv" in _yaml
        && _yaml["webserv"].type.sequence)
        && (_yaml["webserv"].type.mapping
          && _yaml["webserv"].tag.match(rgx.yaml_tag_is_map))
      ) { // cannot be used as is with opt_action FIX look at remaining, decide what to do later
          if ("data_http" in _yaml["webserv"]
            && _yaml["webserv"]["data_http"].type.string
            && _yaml["webserv"]["data_http"].tag.match(rgx.yaml_tag_is_str)
          ) {
            _struct_composite.conf.w_srv_data_http = _yaml["webserv"]["data_http"].get!string;
          }
          // if (_opt_action.*.length > 0) {
          if ("cgi_http" in _yaml["webserv"]
            && _yaml["webserv"]["cgi_http"].type.string
            && _yaml["webserv"]["cgi_http"].tag.match(rgx.yaml_tag_is_str)
          ) {
            _struct_composite.conf.w_srv_cgi_http = _yaml["webserv"]["cgi_http"].get!string;
          }
          // if (_opt_action.*.length > 0) {
          if ("host" in _yaml["webserv"]
            && _yaml["webserv"]["host"].type.string
            && _yaml["webserv"]["host"].tag.match(rgx.yaml_tag_is_str)
          ) {
            _struct_composite.conf.w_srv_host = _yaml["webserv"]["host"].get!string;
          }
          if ("data_root_url" in _yaml["webserv"]
            && _yaml["webserv"]["data_root_url"].type.string
            && _yaml["webserv"]["data_root_url"].tag.match(rgx.yaml_tag_is_str)
          ) {
            _struct_composite.conf.w_srv_data_root_url      = _yaml["webserv"]["data_root_url"].get!string;
            _struct_composite.conf.w_srv_data_root_url_html =
              _yaml["webserv"]["data_root_url"].get!string
              ~ _struct_composite.conf.w_srv_data_root_part ~ "/"
              ~ _manifested.src.language ~ "/"
              ~ "html";
          } else {
            _struct_composite.conf.w_srv_data_root_url =  _struct_composite.conf.w_srv_data_root_part;
            _struct_composite.conf.w_srv_data_root_url_html =
              _struct_composite.conf.w_srv_data_root_part ~ "/"
              ~ _manifested.src.language ~ "/"
              ~ "html";
          }
          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.w_srv_cgi_host = _yaml["webserv"]["cgi_host"].get!string;
          } else { // composite construct
            _struct_composite.conf.w_srv_cgi_host = _struct_composite.conf.w_srv_host;
          }
          if ("cgi_bin_subpath" in _yaml["webserv"]
            && _yaml["webserv"]["cgi_bin_subpath"].type.string
            && _yaml["webserv"]["cgi_bin_subpath"].tag.match(rgx.yaml_tag_is_str)
          ) {
            _struct_composite.conf.w_srv_cgi_bin_subpath = _yaml["webserv"]["cgi_bin_subpath"].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.w_srv_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.w_srv_cgi_user = _yaml["webserv"]["cgi_user"].get!string;
          }
          if ("cgi_bin_url" in _yaml["webserv"]
            && _yaml["webserv"]["cgi_bin_url"].type.string
            && _yaml["webserv"]["cgi_bin_url"].tag.match(rgx.yaml_tag_is_str)
          ) {
            _struct_composite.conf.w_srv_cgi_bin_url = _yaml["webserv"]["cgi_bin_url"].get!string;
          } else {
            _struct_composite.conf.w_srv_cgi_bin_url =
              (_struct_composite.conf.w_srv_cgi_http.empty)
                ? _struct_composite.conf.w_srv_http
                :_struct_composite.conf.w_srv_cgi_http
              ~ "://"
              ~ (_struct_composite.conf.w_srv_cgi_host.empty)
                ? _struct_composite.conf.w_srv_cgi_host
                : _struct_composite.conf.w_srv_host
              ~ _struct_composite.conf.w_srv_cgi_bin_subpath;
          }
          // 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.w_srv_cgi_file_links = _yaml["webserv"]["cgi_file_links"].get!string;
          // }
      }
      // make (in: conf, make, meta)?
      if ("processing" in _yaml
        && _yaml["processing"].type.sequence
      ) {
        if (_yaml["processing"].type.mapping
          && _yaml["processing"].tag.match(rgx.yaml_tag_is_map)
        ) {
          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 ("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 ("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 ("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;
          }
        }
      }
      string[] selected_papersize(string _sizes_str) {
        string[] _sizes = _sizes_str.split(regex(r"\s*,\s*"));
        string[] _selected_sizes;
        foreach (_size; _sizes) {
          switch (_size) {
            case "a4":
              _selected_sizes ~= "a4.portrait";
              _selected_sizes ~= "a4.landscape";
              break;
            case "a4.portrait":
              _selected_sizes ~= _size;
              break;
            case "a4.landscape":
              _selected_sizes ~= _size;
              break;
            case "b4":
              _selected_sizes ~= "b4.portrait";
              _selected_sizes ~= "b4.landscape";
              break;
            case "b4.portrait":
              _selected_sizes ~= _size;
              break;
            case "b4.landscape":
              _selected_sizes ~= _size;
              break;
            case "a5":
              _selected_sizes ~= "a5.portrait";
              _selected_sizes ~= "a5.landscape";
              break;
            case "a5.portrait":
              _selected_sizes ~= _size;
              break;
            case "a5.landscape":
              _selected_sizes ~= _size;
              break;
            case "letter":
              _selected_sizes ~= "letter.portrait";
              _selected_sizes ~= "letter.landscape";
              break;
            case "letter.portrait":
              _selected_sizes ~= _size;
              break;
            case "letter.landscape":
              _selected_sizes ~= _size;
              break;
            case "legal":
              _selected_sizes ~= "legal.portrait";
              _selected_sizes ~= "legal.landscape";
              break;
            case "legal.portrait":
              _selected_sizes ~= _size;
              break;
            case "legal.landscape":
              _selected_sizes ~= _size;
              break;
            default: break;
          }
        }
        return _selected_sizes;
      }
      string _set_papersize;
      if (_opt_action.latex_papersize.length > 0) {
        _set_papersize
          = _opt_action.latex_papersize;
      } else {
        _set_papersize
          = (_cfg.default_papersize.empty)
            ? "a4,letter.portrait"
            : _cfg.default_papersize;
        if ("papersize" in _yaml["default"]
          && _yaml["default"]["papersize"].type.string
          && _yaml["default"]["papersize"].tag.match(rgx.yaml_tag_is_str)
        ) {
          _set_papersize
            = _yaml["default"]["papersize"].get!string;
        }
      }
      _struct_composite.conf.set_papersize = selected_papersize(_set_papersize);
      if (
        "default" in _yaml
        && _yaml["default"].type.sequence
        && _yaml["default"].type.mapping
        && _yaml["default"].tag.match(rgx.yaml_tag_is_map)
      ) {
        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.set_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.set_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.set_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.set_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;
          }
        }
      }
    } else {
      /+ make ------------------------------------------------------------------- +/
      if ("make" in _yaml
        && _yaml["make"].type.sequence
      ) {
        if (_yaml["make"].type.mapping
          && _yaml["make"].tag.match(rgx.yaml_tag_is_map)
        ) {
          if ("doc_type" in _yaml["make"]
            && _yaml["make"]["doc_type"].type.string
            && _yaml["make"]["doc_type"].tag.match(rgx.yaml_tag_is_str)
          ) {
            _struct_composite.make_str.doc_type = _yaml["make"]["doc_type"].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 ("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 ("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;
          } else 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_seq)
          ) {
            _struct_composite.make_str.home_button_text = "";
            foreach(string hbt; _yaml["make"]["home_button_text"]) {
              _struct_composite.make_str.home_button_text ~= hbt ~ "; ";
            }
          }
          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.doc_type                 = _mk.doc_type(_struct_composite.make_str.doc_type);
        _struct_composite.make.breaks                   = _mk.breaks(_struct_composite.make_str.breaks);
        _struct_composite.make.bold                     = _mk.bold(_struct_composite.make_str.bold);
        _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);
      }
      /+ 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) {
          if (auto m = author_raw.match(rgx.raw_author_munge)) {
            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");
            (m.captures[1]).map!toUpper.copy(_lastname);
            authors_hash_arr["last_first"] ~= _lastname.data.to!string ~ ", " ~ m.captures[2];
            _lastname = appender!(char[])();
          } else {
            author_arr                     ~= author_raw;
            authors_hash_arr["last"]       ~= author_raw;
            authors_hash_arr["full"]       ~= author_raw;
            authors_hash_arr["last_first"] ~= author_raw;
          }
          authors_hash_arr["as_input"] ~= author_raw;
        }
        _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"].length > 0) ? 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;
            if (_struct_composite.meta.classify_topic_register.length > 0) {
              auto wrds = ctRegex!(`([\wa-zA-Z(). -]+)`); // ctRegex!(`([(]?\w+[a-zA-Z(). -]*)+`);
              auto mkp_delim = ctRegex!(`:([^:]+?)(;|$)`);
              string _topic_register = _struct_composite.meta.classify_topic_register;
              _topic_register = _topic_register
                .replaceAll(wrds, "\"$1\"")
                .replaceAll(mkp_delim, ":$1$2");
            }
            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;
              }
            }
            _struct_composite.meta.classify_topic_register_arr = topics;
            string[] topics_expanded;
            if (_struct_composite.meta.classify_topic_register_arr.length > 0) {
              foreach (i, topic; _struct_composite.meta.classify_topic_register_arr) {
                string[] subject_tree = topic.split(mkup.sep);
                if (topic.length > 0) {
                  topics_expanded ~= subject_tree.join(", ");
                }
              }
            }
            _struct_composite.meta.classify_topic_register_expanded_arr = topics_expanded;
            // writeln("\n------\n", _struct_composite.meta.title_full);
            // writeln(_struct_composite.meta.classify_topic_register);
            // writeln(_struct_composite.meta.classify_topic_register_expanded_arr.sort.join("\n"));
            // writeln(_struct_composite.meta.classify_topic_register_arr);
          }
        }
      }
      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 = _manifested.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 ("summary" in _yaml["notes"]
            && _yaml["notes"]["summary"].type.string
            && _yaml["notes"]["summary"].tag.match(rgx.yaml_tag_is_str)
          ) {
            _struct_composite.meta.notes_summary = _yaml["notes"]["summary"].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 = check_input_markup(_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 = check_input_markup(_yaml["rights"]["license"].get!string);
          }
        }
      }
    }
    return _struct_composite;
  }
}
template configParseYAMLreturnSpineStruct() {
  import dyaml;
  import
    doc_reform.meta.conf_make_meta_structs,
    doc_reform.meta.conf_make_meta_json;
  mixin contentYAMLtoSpineStruct;
  @system auto configParseYAMLreturnSpineStruct(T,CCm,M,O,Cfg)(
    T       _document_struct,
    CCm     _make_and_meta_struct,
    M       _manifested,
    O       _opt_action,
    Cfg     _cfg
  ){
    Node _yaml;
    if (_document_struct.content.length > 0) {
      try {
        _yaml = Loader.fromString(_document_struct.content).load();
      } catch (Throwable) {
        import std.stdio;
        writeln("ERROR failed to parse content as yaml: ", _document_struct.filename);
        // writeln(_document_struct.content);
      }
      try {
      _make_and_meta_struct
        = contentYAMLtoSpineStruct!()(_make_and_meta_struct, _yaml, _manifested, _opt_action, _cfg, _document_struct.filename);
      } catch (Throwable) {
        import std.stdio;
        writeln("ERROR failed to convert yaml to struct: ", _document_struct.filename);
      }
    }
    return _make_and_meta_struct;
  }
}
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 spineRgxIn;
  mixin contentJSONtoSpineStruct;
  static auto rgx = RgxI();
  @system auto docHeaderMakeAndMetaTupYamlExtractAndConvertToStruct(CCm,Src,M,O,Cfg)(
    Src     header_src,
    CCm     _make_and_meta_struct,
    M       _manifested,
    O       _opt_action,
    Cfg     _cfg,
  ) {
    Node _yaml;
    try {
      _yaml = Loader.fromString(header_src).load();
      if (("title" in _yaml) && ("creator" in _yaml)) {} else { // need test for _yaml content (does not work)
        writeln("ERROR failed to read document header, yaml header does not contain essential information related to title and author");
      }
      return contentYAMLtoSpineStruct!()(_make_and_meta_struct, _yaml, _manifested, _opt_action, _cfg, "header");
    } catch (Throwable) {
      writeln("ERROR failed to read document header, header not parsed as yaml: ", _manifested.src.filename);
      return _make_and_meta_struct;
    }
  }
}