0.9.0 spine (doc-reform renamed)

1 files changed, 0 insertions, 2012 deletions

diff --git a/org/doc_reform.org b/org/doc_reform.org
deleted file mode 100644
index 0b98147..0000000
--- a/org/doc_reform.org
+++ /dev/null
@@ -1,2012 +0,0 @@
--*- mode: org -*-
-#+TITLE:       doc_reform hub
-#+DESCRIPTION: documents - structuring, various output representations & search
-#+FILETAGS:    :doc_reform:hub:
-#+AUTHOR:      Ralph Amissah
-#+EMAIL:       [[mailto:ralph.amissah@gmail.com][ralph.amissah@gmail.com]]
-#+COPYRIGHT:   Copyright (C) 2015 - 2019 Ralph Amissah
-#+LANGUAGE:    en
-#+STARTUP:     indent content hideblocks hidestars
-#+OPTIONS:     H:3 num:nil toc:t \n:nil @:t ::t |:t ^:nil _:nil -:t f:t *:t <:t
-#+OPTIONS:     TeX:t LaTeX:t skip:nil d:nil todo:t pri:nil tags:not-in-toc
-#+OPTIONS:     author:nil email:nil creator:nil timestamp:nil
-#+PROPERTY:    header-args :results silent :padline no :exports code :cache no :noweb yes
-#+EXPORT_SELECT_TAGS:  export
-#+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: assert(a) class(c) debug(d) mixin(m) doc_reform(s) tangle(T) template(t) WEB(W) noexport(n)
-
-[[../maker.org][maker.org makefile]]  [[./][org/]]
-
-* 0. version.txt (set version)                                      :version:
-** set program version
-- set program version
-
-#+BEGIN_SRC d  :tangle "../views/version.txt"
-/+ obt - org generated file +/
-struct Version {
-  int major;
-  int minor;
-  int patch;
-}
-enum _ver = Version(0, 8, 3);
-#+END_SRC
-
-** compilation restrictions (supported compilers)
-- set compilation restrictions
-
-http://dlang.org/spec/version.html#predefined-versions
-
-#+BEGIN_SRC d  :tangle "../views/version.txt"
-version (Posix) {
-  version (DigitalMars) {
-  } else version (LDC) {
-  } else version (GNU) {
-  } else {
-    static assert (0, "Unsupported D compiler");
-  }
-} else {
-  static assert (0, "Unsupported D compiler");
-}
-#+END_SRC
-
-* 1. doc_reform (sisu document parser)                           :doc_reform:
-** notes
-- deal with imports
-- get options
-  - get command line instructions
-  - read config instructions
-- process files as instructed by options
-  - read in file
-  - process file
-  - output
-
-** 0. doc_reform src/doc_reform                                   :template:
-
-- process files (act according to requirements of each type)
-  - by sourcefilename
-  - by sourcefiles contents identifier
-  - by zip filename
-
-#+BEGIN_SRC d  :tangle "../src/doc_reform/doc_reform.d" :shebang #!/usr/bin/env rdmd
-<<doc_header_including_copyright_and_license>>
-module doc_reform.sisu_document_parser;
-import
-  doc_reform.conf.compile_time_info,
-  doc_reform.meta.metadoc;
-<<imports_doc_reform>>
-import std.algorithm;
-import std.parallelism;
-<<mixin_doc_reform_version>>
-<<mixin_pre_main>>
-string project_name = "DocReform";
-string program_name = "doc-reform";
-/++
-name        "doc_reform"
-description "A SiSU inspired document parser writen in D."
-homepage    "http://sisudoc.org"
-+/
-void main(string[] args) {
-  <<doc_reform_mixin>>
-  <<doc_reform_init>>
-  <<doc_reform_args>>
-  <<doc_reform_do_selected>>
-  if (_manifests.length > 1                            // _manifests[0] initialized dummy element
-  && _opt_action.abstraction) {
-    if (_opt_action.parallelise) {                     // see else
-      foreach(manifest; parallel(_manifests[1..$])) {
-        if (!empty(manifest.src.filename)) {
-          <<doc_reform_each_file_do_scope>>
-          <<doc_reform_each_file_do_abstraction>>
-          <<doc_reform_each_file_do_debugs_checkdoc>>
-          <<doc_reform_each_file_do_selected_output>>
-          <<doc_reform_each_file_do_scope_exit>>
-        } else {
-          <<doc_reform_no_filename_provided>>
-        }
-      }
-    } else {                                           // note cannot parallelise sqlite shared db
-      foreach(manifest; _manifests[1..$]) {
-        writeln("parallelisation off: actions include sqlite shared db");
-        if (!empty(manifest.src.filename)) {
-          <<doc_reform_each_file_do_scope>>
-          <<doc_reform_each_file_do_abstraction>>
-          <<doc_reform_each_file_do_debugs_checkdoc>>
-          <<doc_reform_each_file_do_selected_output>>
-          <<doc_reform_each_file_do_scope_exit>>
-        } else {
-          <<doc_reform_no_filename_provided>>
-        }
-      }
-    }
-  }
-  if (hvst.harvests.length > 0) {
-    if (_opt_action.harvest_topics) {
-      DocReformMetaDocHarvestsTopics!()(hvst, _make_and_meta_struct, _opt_action);
-    }
-    if (_opt_action.harvest_authors) {
-      DocReformMetaDocHarvestsAuthors!()(hvst.harvests, _make_and_meta_struct, _opt_action);
-    }
-    if (!(_opt_action.quiet)) {
-      import doc_reform.output.paths_output;
-      auto out_pth = DocReformPathsHTML!()(_make_and_meta_struct.conf.output_path, "");
-      if (_opt_action.harvest_authors) {
-        writeln("- ", out_pth.harvest("authors.html"));
-      }
-      if (_opt_action.harvest_topics) {
-        writeln("- ", out_pth.harvest("topics.html"));
-      }
-    }
-  }
-}
-#+END_SRC
-
-*** document header including copyright & license
-
-#+NAME: doc_header_including_copyright_and_license
-#+BEGIN_SRC text
-/+
-- Name: Doc Reform
-  - Description: documents, structuring, processing, publishing, search
-    - static content generator
-
-  - Author: Ralph Amissah
-    [ralph.amissah@gmail.com]
-
-  - Copyright: (C) 2015 - 2019 Ralph Amissah, All Rights
-    Reserved.
-
-  - License: AGPL 3 or later:
-
-    Doc Reform (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 [http://www.gnu.org/licenses/].
-
-    If you have Internet connection, the latest version of the AGPL should be
-    available at these locations:
-    [http://www.fsf.org/licensing/licenses/agpl.html]
-    [http://www.gnu.org/licenses/agpl.html]
-
-  - 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
-
-  - Hompages:
-    [http://www.doc_reform.org]
-    [http://www.sisudoc.org]
-
-  - Git
-    [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-    [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html.rb;hb=HEAD]
-
-+/
-#+END_SRC
-
-** 1. pre-loop init                                                   :init:
-*** init
-**** imports                                                      :import:
-***** doc_reform                                             :doc_reform:
-
-#+NAME: imports_doc_reform
-#+BEGIN_SRC d
-import
-  std.datetime,
-  std.getopt,
-  std.file,
-  std.path,
-  std.process;
-import
-  doc_reform.meta,
-  doc_reform.meta.metadoc_harvest,
-  doc_reform.meta.metadoc_harvests_authors,
-  doc_reform.meta.metadoc_harvests_topics,
-  doc_reform.meta.metadoc_from_src,
-  doc_reform.meta.conf_make_meta_structs,
-  doc_reform.meta.conf_make_meta_json,
-  doc_reform.meta.defaults,
-  doc_reform.meta.doc_debugs,
-  doc_reform.meta.rgx,
-  doc_reform.source.paths_source,
-  doc_reform.source.read_config_files,
-  doc_reform.source.read_source_files,
-  doc_reform.output.hub;
-#+END_SRC
-
-****** notes
-├── src
-│   ├── doc_reform.d
-│   └── doc_reform
-│       ├── conf
-│       ├── meta
-│       └── output
-└── views
-    └── version.txt
-
-[[./meta_abstraction.org][meta_abstraction]]
-[[./meta_conf_make_meta.org][meta_conf_make_meta]]
-[[./meta_defaults.org][meta_defaults]]
-[[./meta_output_debugs.org][meta_output_debugs]]
-[[./source_read_files.org][source_read_files]]
-[[./compile_time_info.org][compile time info]]
-[[./output.org][output]]
-[[./doc_reform.org][doc_reform]]
-
-keep up to date, configuration in ../maker.org
-
-**** mixins                                                        :mixin:
-***** version.txt                                               :version:
-
-#+NAME: mixin_doc_reform_version
-#+BEGIN_SRC d
-mixin(import("version.txt"));
-#+END_SRC
-
-***** pre main mixins
-
-#+NAME: mixin_pre_main
-#+BEGIN_SRC d
-mixin CompileTimeInfo;
-#+END_SRC
-
-***** doc_reform "main" mixins                               :doc_reform:
-
-#+NAME: doc_reform_mixin
-#+BEGIN_SRC d
-mixin DocReformRgxInit;
-mixin contentJSONtoDocReformStruct;
-mixin DocReformBiblio;
-mixin DocReformRgxInitFlags;
-mixin outputHub;
-#+END_SRC
-
-**** init                                                           :init:
-
-#+NAME: doc_reform_init
-#+BEGIN_SRC d
-auto hvst = DocReformHarvest!();
-#+END_SRC
-
-**** args                                                           :args:
-
-#+NAME: doc_reform_init
-#+BEGIN_SRC d
-string flag_action;
-string arg_unrecognized;
-enum dAM { abstraction, matters }
-static auto rgx = Rgx();
-#+END_SRC
-
-*** scope (run complete)                                            :scope:
-
-#+NAME: doc_reform_init
-#+BEGIN_SRC d
-scope(success) {
-  writefln(
-    "~ run complete, ok ~ (%s-%s.%s.%s, %s D:%s, %s %s)",
-    program_name,
-    _ver.major, _ver.minor, _ver.patch,
-    __VENDOR__, __VERSION__,
-    bits, os,
-  );
-}
-scope(failure) {
-  debug(checkdoc) {
-    stderr.writefln(
-      "run failure",
-    );
-  }
-}
-#+END_SRC
-
-*** getopt args for loop                                      :args:getopt:
-
-**** set getopt options
-- set getopt options
-
-#+NAME: doc_reform_args
-#+BEGIN_SRC d
-bool[string] opts = [
-  "abstraction"        : false,
-  "assertions"         : false,
-  "concordance"        : false,
-  "dark"               : false,
-  "debug"              : false,
-  "digest"             : false,
-  "epub"               : false,
-  "harvest"            : false,
-  "harvest-authors"    : false,
-  "harvest-topics"     : false,
-  "html"               : false,
-  "html-seg"           : false,
-  "html-scroll"        : false,
-  "latex"              : false,
-  "light"              : false,
-  "manifest"           : false,
-  "hide-ocn"           : false,
-  "ocn-off"            : false,
-  "odf"                : false,
-  "odt"                : false,
-  "parallel"           : false,
-  "parallel-subprocesses" : false,
-  "pdf"                : false,
-  "quiet"              : false,
-  "pod"                : false,
-  "serial"             : false,
-  "show-summary"       : false,
-  "show-metadata"      : false,
-  "show-make"          : false,
-  "show-config"        : false,
-  "source"             : false,
-  "sqlite-discrete"    : false,
-  "sqlite-db-create"   : false,
-  "sqlite-db-drop"     : false,
-  "sqlite-db-recreate" : false,
-  "sqlite-delete"      : false,
-  "sqlite-insert"      : false,
-  "sqlite-update"      : false,
-  "text"               : false,
-  "verbose"            : false,
-  "very-verbose"       : false,
-  "xhtml"              : false,
-  "section_toc"        : true,
-  "section_body"       : true,
-  "section_endnotes"   : true,
-  "section_glossary"   : true,
-  "section_biblio"     : true,
-  "section_bookindex"  : true,
-  "section_blurb"      : true,
-  "backmatter"         : true,
-  "skip-output"        : false,
-  "theme-dark"         : false,
-  "theme-light"        : false,
-  "workon"             : false,
-];
-string[string] settings = [
-  "config"             : "",
-  "output"             : "",
-  "lang"               : "all",
-  "sqlite-filename"    : "documents",
-];
-auto helpInfo = getopt(args,
-  std.getopt.config.passThrough,
-  "abstraction",        "--abstraction document abstraction ",                                      &opts["abstraction"],
-  "assert",             "--assert set optional assertions on",                                      &opts["assertions"],
-  "concordance",        "--concordance file for document",                                          &opts["concordance"],
-  "dark",               "--dark alternative dark theme",                                            &opts["dark"],
-  "debug",              "--debug",                                                                  &opts["debug"],
-  "digest",             "--digest hash digest for each object",                                     &opts["digest"],
-  "epub",               "--epub process epub output",                                               &opts["epub"],
-  "harvest",            "--harvest extract info on authors & topics from document header metadata", &opts["harvest"],
-  "harvest-authors",    "--harvest-authors extract info on authors from document header metadata",  &opts["harvest-authors"],
-  "harvest-topics",     "--harvest-topics extract info on topics from document header metadata",    &opts["harvest-topics"],
-  "html",               "--html process html output",                                               &opts["html"],
-  "html-seg",           "--html-seg process html output",                                           &opts["html-seg"],
-  "html-scroll",        "--html-seg process html output",                                           &opts["html-scroll"],
-  "latex",              "--latex output for pdfs",                                                  &opts["latex"],
-  "light",              "--light default light theme",                                              &opts["light"],
-  "manifest",           "--manifest process manifest output",                                       &opts["manifest"],
-  "hide-ocn",           "--hide-ocn object cite numbers",                                           &opts["hide-ocn"],
-  "ocn-off",            "--ocn-off object cite numbers",                                            &opts["ocn-off"],
-  "odf",                "--odf open document format text (--odt)",                                  &opts["odf"],
-  "odt",                "--odt open document format text",                                          &opts["odt"],
-  "parallel",           "--parallel parallelisation",                                               &opts["parallel"],
-  "parallel-subprocesses", "--parallel-subprocesses nested parallelisation",                        &opts["parallel-subprocesses"],
-  "quiet|q",            "--quiet output to terminal",                                               &opts["quiet"],
-  "pdf",                "--pdf latex output for pdfs",                                              &opts["pdf"],
-  "pod",                "--pod doc reform pod source content bundled",                              &opts["pod"],
-  "serial",             "--serial serial processing",                                               &opts["serial"],
-  "show-summary",       "--show-summary",                                                           &opts["show-summary"],
-  "show-make",          "--show-make",                                                              &opts["show-make"],
-  "show-metadata",      "--show-metadata",                                                          &opts["show-metadata"],
-  "show-config",        "--show-config",                                                            &opts["show-config"],
-  "source",             "--source markup source text content",                                      &opts["source"],
-  "sqlite-discrete",    "--sqlite process discrete sqlite output",                                  &opts["sqlite-discrete"],
-  "sqlite-db-create",   "--sqlite-db-create create db, create tables",                              &opts["sqlite-db-create"],
-  "sqlite-db-drop",     "--sqlite-db-drop drop tables & db",                                        &opts["sqlite-db-drop"],
-  "sqlite-db-recreate", "--sqlite-db-recreate create db, create tables",                            &opts["sqlite-db-recreate"],
-  "sqlite-delete",      "--sqlite-delete process sqlite output",                                    &opts["sqlite-delete"],
-  "sqlite-insert",      "--sqlite-insert process sqlite output",                                    &opts["sqlite-insert"],
-  "sqlite-update",      "--sqlite-update process sqlite output",                                    &opts["sqlite-update"],
-  "text",               "--text process text output",                                               &opts["text"],
-  "txt",                "--txt process text output",                                                &opts["text"],
-  "verbose|v",          "--verbose output to terminal",                                             &opts["verbose"],
-  "very-verbose",       "--very-verbose output to terminal",                                        &opts["very-verbose"],
-  "xhtml",              "--xhtml process xhtml output",                                             &opts["xhtml"],
-  "section-toc",        "--section-toc process table of contents (default)",                        &opts["section_toc"],
-  "section-body",       "--section-body process document body (default)",                           &opts["section_body"],
-  "section-endnotes",   "--section-endnotes process document endnotes (default)",                   &opts["section_endnotes"],
-  "section-glossary",   "--section-glossary process document glossary (default)",                   &opts["section_glossary"],
-  "section-biblio",     "--section-biblio process document biblio (default)",                       &opts["section_biblio"],
-  "section-bookindex",  "--section-bookindex process document bookindex (default)",                 &opts["section_bookindex"],
-  "section-blurb",      "--section-blurb process document blurb (default)",                         &opts["section_blurb"],
-  "backmatter",         "--section-backmatter process document backmatter (default)",               &opts["backmatter"],
-  "skip-output",        "--skip-output",                                                            &opts["skip-output"],
-  "theme-dark",         "--theme-dark alternative dark theme",                                      &opts["theme-dark"],
-  "theme-light",        "--theme-light default light theme",                                        &opts["theme-light"],
-  "workon",             "--workon (reserved for some matters under development & testing)",         &opts["workon"],
-  "config",             "--config=/path/to/config/file/including/filename",                         &settings["config"],
-  "output",             "--output=/path/to/output/dir specify where to place output",               &settings["output"],
-  "sqlite-filename",    "--sqlite-filename=[filename].sqlite",                                      &settings["sqlite-filename"],
-  "lang",               "--lang=[lang code e.g. =en or =en,es]",                                    &settings["lang"],
-);
-if (helpInfo.helpWanted) {
-  defaultGetoptPrinter("Some information about the program.", helpInfo.options);
-}
-#+END_SRC
-
-**** getopt hash to struct
-- move getopt options to struct
-
-#+NAME: doc_reform_args
-#+BEGIN_SRC d
-enum outTask { source_or_pod, sqlite, sqlite_multi, latex, odt, epub, html_scroll, html_seg, html_stuff }
-struct OptActions {
-  bool assertions() {
-    return opts["assertions"];
-  }
-  bool concordance() {
-    return opts["concordance"];
-  }
-  auto config_path_set() {
-    return settings["config"];
-  }
-  bool css_theme_default() {
-    bool _is_light;
-    if (opts["light"] || opts["theme-light"]) {
-      _is_light = true;
-    } else if (opts["dark"] || opts["theme-dark"]) {
-      _is_light = false;
-    } else {
-      _is_light = true;
-    }
-    return _is_light;
-  }
-  bool debug_do() {
-    return opts["debug"];
-  }
-  bool digest() {
-    return opts["digest"];
-  }
-  bool epub() {
-    return opts["epub"];
-  }
-  bool harvest() {
-    return (opts["harvest"] || opts["harvest-authors"] || opts["harvest-topics"]) ? true : false;
-  }
-  bool harvest_authors() {
-    return (opts["harvest"] || opts["harvest-authors"]) ? true : false;
-  }
-  bool harvest_topics() {
-    return (opts["harvest"] || opts["harvest-topics"]) ? true : false;
-  }
-  bool html() {
-    return (opts["html"] || opts["html-seg"] || opts["html-scroll"]) ? true : false;
-  }
-  bool html_seg() {
-    return (opts["html"] || opts["html-seg"]) ? true : false;
-  }
-  bool html_scroll() {
-    return (opts["html"] || opts["html-scroll"]) ? true : false;
-  }
-  bool html_stuff() {
-    return (opts["html"] || opts["html-scroll"] || opts["html-seg"]) ? true : false;
-  }
-  bool latex() {
-    return (opts["latex"] || opts["pdf"]) ? true : false;
-  }
-  bool odt() {
-    return (opts["odf"] || opts["odt"]) ? true : false;
-  }
-  bool manifest() {
-    return opts["manifest"];
-  }
-  bool ocn_hidden() {
-    return opts["hide-ocn"];
-  }
-  bool ocn_off() {
-    return opts["ocn-off"];
-  }
-  bool quiet() {
-    return opts["quiet"];
-  }
-  bool pod() {
-    return opts["pod"];
-  }
-  bool show_summary() {
-    return opts["show-summary"];
-  }
-  bool show_make() {
-    return opts["show-make"];
-  }
-  bool show_metadata() {
-    return opts["show-metadata"];
-  }
-  bool show_config() {
-    return opts["show-config"];
-  }
-  bool source() {
-    return opts["source"];
-  }
-  bool source_or_pod() {
-    return (opts["pod"] || opts["source"]) ? true : false;
-  }
-  bool sqlite_discrete() {
-    return opts["sqlite-discrete"];
-  }
-  bool sqlite_db_drop() {
-    return (opts["sqlite-db-recreate"] || opts["sqlite-db-drop"]) ? true : false;
-  }
-  bool sqlite_db_create() {
-    return (opts["sqlite-db-recreate"] || opts["sqlite-db-create"]) ? true : false;
-  }
-  bool sqlite_delete() {
-    return opts["sqlite-delete"];
-  }
-  bool sqlite_update() {
-    return (opts["sqlite-update"] || opts["sqlite-insert"]) ? true : false;
-  }
-  bool sqlite_shared_db_action() {
-    return (
-      opts["sqlite-db-recreate"]
-      || opts["sqlite-db-create"]
-      || opts["sqlite-delete"]
-      || opts["sqlite-insert"]
-      || opts["sqlite-update"]
-    ) ? true : false;
-  }
-  bool text() {
-    return opts["text"];
-  }
-  bool verbose() {
-    return (opts["verbose"] || opts["very-verbose"]) ? true : false;
-  }
-  bool very_verbose() {
-    return opts["very-verbose"];
-  }
-  bool xhtml() {
-    return opts["xhtml"];
-  }
-  bool section_toc() {
-    return opts["section_toc"];
-  }
-  bool section_body() {
-    return opts["section_body"];
-  }
-  bool section_endnotes() {
-    return opts["section_endnotes"];
-  }
-  bool section_glossary() {
-    return opts["section_glossary"];
-  }
-  bool section_biblio() {
-    return opts["section_biblio"];
-  }
-  bool section_bookindex() {
-    return opts["section_bookindex"];
-  }
-  bool section_blurb() {
-    return opts["section_blurb"];
-  }
-  bool backmatter() {
-    return opts["backmatter"];
-  }
-  bool skip_output() {
-    return opts["skip-output"];
-  }
-  bool workon() {
-    return opts["workon"];
-  }
-  auto languages_set() {
-    return settings["lang"].split(",");
-  }
-  auto output_dir_set() {
-    return settings["output"];
-  }
-  auto sqlite_filename() {
-    return settings["sqlite-filename"];
-  }
-  bool parallelise() {
-    bool _is;
-    if (opts["parallel"] == true) {
-      _is = true;
-      if (sqlite_shared_db_action) { _is = false; }
-    } else if (opts["parallel"] == false
-    && opts["serial"] == true) {
-      _is = false;
-    } else if (
-      opts["abstraction"]
-      || concordance
-      || harvest
-      || html
-      || epub
-      || odt
-      || latex
-      || manifest
-      || source_or_pod
-      || sqlite_discrete
-    ) {
-      _is = true;
-    } else { _is = false; }
-    return _is;
-  }
-  bool parallelise_subprocesses() {
-    return opts["parallel-subprocesses"];
-  }
-  auto output_task_scheduler() {
-    int[] schedule;
-    if (source_or_pod) {
-      schedule ~= outTask.source_or_pod;
-    }
-    if (sqlite_discrete) {
-      schedule ~= outTask.sqlite;
-    }
-    if (epub) {
-      schedule ~= outTask.epub;
-    }
-    if (html_scroll) {
-      schedule ~= outTask.html_scroll;
-    }
-    if (html_seg) {
-      schedule ~= outTask.html_seg;
-    }
-    if (html_stuff) {
-      schedule ~= outTask.html_stuff;
-    }
-    if (odt) {
-      schedule ~= outTask.odt;
-    }
-    if (latex) {
-      schedule ~= outTask.latex;
-    }
-    return schedule.sort().uniq;
-  }
-  bool abstraction() {
-    return (
-      opts["abstraction"]
-      || concordance
-      || source_or_pod
-      || harvest
-      || html
-      || epub
-      || odt
-      || latex
-      || manifest
-      || sqlite_discrete
-      || sqlite_delete
-      || sqlite_update
-    ) ? true : false;
-  }
-  bool meta_processing_general() {
-    return (
-      opts["abstraction"]
-      || html
-      || epub
-      || odt
-      || latex
-      || sqlite_discrete
-      || sqlite_update
-    ) ? true :false;
-  }
-  bool meta_processing_xml_dom() {
-    return (
-      opts["abstraction"]
-      || html
-      || epub
-      || odt
-      || sqlite_discrete
-      || sqlite_update
-    ) ? true : false;
-  }
-}
-auto _opt_action = OptActions();
-#+END_SRC
-
-**** env
-- environmental info
-
-#+NAME: doc_reform_args
-#+BEGIN_SRC d
-auto program_info() {
-  struct ProgramInfo {
-    string project() {
-      return project_name;
-    }
-    string name() {
-      return program_name;
-    }
-    string ver() {
-      string ver_ = format(
-        "%s.%s.%s",
-        _ver.major, _ver.minor, _ver.patch,
-      );
-      return ver_;
-    }
-    string compiler() {
-      string ver_ = format(
-        "%s D:%s, %s %s",
-        __VENDOR__, __VERSION__,
-        bits, os,
-      );
-      return ver_;
-    }
-  }
-  return ProgramInfo();
-}
-auto _env = [
-  "pwd" :     environment["PWD"],
-  "home" :    environment["HOME"],
-];
-#+END_SRC
-
-*** opt actions on processing files & file paths (pods, src etc.)
-
-#+NAME: doc_reform_args
-#+BEGIN_SRC d
-auto _manifested = PathMatters!()(_opt_action, _env, "");
-auto _manifests = [ _manifested ];
-ConfComposite _make_and_meta_struct;
-if (_opt_action.config_path_set.empty) {
-  foreach(arg; args[1..$]) {
-    if (!(arg.match(rgx.flag_action))) { /+ cli markup source path +/ // get first input markup source file names for processing
-      _manifested = PathMatters!()(_opt_action, _env, arg);
-      { /+ local site config +/
-        auto _config_local_site_struct = readConfigSite!()(_manifested, _env);
-        if (_config_local_site_struct.filetype == "yaml") {
-          import doc_reform.meta.conf_make_meta_yaml;
-          _make_and_meta_struct = _config_local_site_struct.configParseYAMLreturnDocReformStruct!()(_make_and_meta_struct, _manifested); // - get local site config
-          break;
-        }
-      }
-    }
-  }
-} else {
-  { /+ local site config +/
-    auto _config_local_site_struct = readConfigSite!()(_manifested, _env, _opt_action.config_path_set);
-    if (_config_local_site_struct.filetype == "yaml") {
-      import doc_reform.meta.conf_make_meta_yaml;
-      _make_and_meta_struct = _config_local_site_struct.configParseYAMLreturnDocReformStruct!()(_make_and_meta_struct, _manifested); // - get local site config
-    }
-  }
-}
-foreach(arg; args[1..$]) { // refigure how args relate to _opt_action, need path from _opt_action or args early _manifested too late, work on (search for PathMatters and .harvest,
-  auto _manifest_start = PodManifest!()(arg);
-  if (arg.match(rgx.flag_action)) { /+ cli instruction, flag do +/
-    flag_action ~= " " ~ arg;   // flags not taken by getopt
-  } else { /+ cli, assumed to be path to source files +/
-    if ( /+ pod files +/
-      !(arg.match(rgx.src_pth_sst_or_ssm))
-      && _manifest_start.pod_manifest_file_with_path
-      && _opt_action.abstraction
-    ) {
-      string pod_manifest_root_content_paths_to_markup_location_raw_;
-      string markup_contents_location_;
-      string sisudoc_txt_ = _manifest_start.pod_manifest_file_with_path;
-      enforce(
-        exists(sisudoc_txt_)!=0,
-        "file not found: «" ~
-        sisudoc_txt_ ~ "»"
-      );
-      if (exists(sisudoc_txt_)) {
-        try {
-          if (exists(sisudoc_txt_)) {
-            import dyaml;
-            try {
-              Node pod_manifest_yaml = Loader.fromFile(sisudoc_txt_).load();
-              if ("doc" in pod_manifest_yaml) {
-                if (pod_manifest_yaml["doc"].type.mapping
-                  && pod_manifest_yaml["doc"].tag.match(rgx.yaml_tag_is_map)
-                ) {
-                  if ("path" in pod_manifest_yaml["doc"]) {
-                    if (pod_manifest_yaml["doc"]["path"].tag.match(rgx.yaml_tag_is_seq)) {
-                      foreach (string _path; pod_manifest_yaml["doc"]["path"]) {
-                        markup_contents_location_ ~= _path ~ "\n";
-                        pod_manifest_root_content_paths_to_markup_location_raw_ ~=
-                          _path ~ "\n";
-                      }
-                    } else if (
-                      pod_manifest_yaml["doc"]["path"].type.string
-                      && pod_manifest_yaml["doc"]["path"].tag.match(rgx.yaml_tag_is_str)
-                    ) {
-                      markup_contents_location_ = pod_manifest_yaml["doc"]["path"].get!string;
-                      pod_manifest_root_content_paths_to_markup_location_raw_ =
-                        pod_manifest_yaml["doc"]["path"].get!string;
-                    }
-                  }
-                  if ("filename" in pod_manifest_yaml["doc"]) {
-                    if (pod_manifest_yaml["doc"]["filename"].tag.match(rgx.yaml_tag_is_seq)) {
-                      foreach (string _filename; pod_manifest_yaml["doc"]["filename"]) {
-                        if ("language" in pod_manifest_yaml["doc"]) {
-                          if (pod_manifest_yaml["doc"]["language"].tag.match(rgx.yaml_tag_is_seq)) {
-                            foreach (string _lang; pod_manifest_yaml["doc"]["language"]) {
-                              markup_contents_location_ ~=
-                                "media/text/"
-                                ~ _lang ~ "/"
-                                ~ _filename ~ "\n";
-                            }
-                          } else if (pod_manifest_yaml["doc"]["language"].tag.match(rgx.yaml_tag_is_str)
-                          ) {
-                            markup_contents_location_ =
-                              "media/text/"
-                              ~ pod_manifest_yaml["doc"]["language"].get!string
-                              ~ "/" ~ _filename ~ "\n";
-                          } else {
-                            string _lang_default = "en";
-                            markup_contents_location_ ~=
-                              "media/text/"
-                              ~ _lang_default ~ "/"
-                              ~ pod_manifest_yaml["doc"]["filename"].get!string ~ "\n";
-                          }
-                        } else {
-                          string _lang_default = "en";
-                          markup_contents_location_ ~=
-                            "media/text/"
-                            ~ _lang_default ~ "/"
-                            ~ pod_manifest_yaml["doc"]["filename"].get!string ~ "\n";
-                        }
-                      }
-                    } else if (
-                      pod_manifest_yaml["doc"]["filename"].type.string
-                      && pod_manifest_yaml["doc"]["filename"].tag.match(rgx.yaml_tag_is_str)
-                    ) {
-                      if ("language" in pod_manifest_yaml["doc"]) {
-                        if (pod_manifest_yaml["doc"]["language"].tag.match(rgx.yaml_tag_is_seq)) {
-                          foreach (string _lang; pod_manifest_yaml["doc"]["language"]) {
-                            markup_contents_location_ ~=
-                              "media/text/"
-                              ~ _lang ~ "/"
-                              ~ pod_manifest_yaml["doc"]["filename"].get!string ~ "\n";
-                          }
-                        } else if (pod_manifest_yaml["doc"]["language"].tag.match(rgx.yaml_tag_is_str)) {
-                          markup_contents_location_ =
-                            "media/text/"
-                            ~ pod_manifest_yaml["doc"]["language"].get!string
-                            ~ "/" ~ pod_manifest_yaml["doc"]["filename"].get!string ~ "\n";
-                        } else {
-                          string _lang_default = "en";
-                          markup_contents_location_ ~=
-                            "media/text/"
-                            ~ _lang_default ~ "/"
-                            ~ pod_manifest_yaml["doc"]["filename"].get!string ~ "\n";
-                        }
-                      } else {
-                        string _lang_default = "en";
-                        markup_contents_location_ ~=
-                          "media/text/"
-                          ~ _lang_default ~ "/"
-                          ~ pod_manifest_yaml["doc"]["filename"].get!string ~ "\n";
-                      }
-                    }
-                  }
-                }
-              }
-
-            } catch (ErrnoException ex) {
-            }
-          }
-        } catch (ErrnoException ex) {
-        } catch (FileException ex) {
-          // Handle errors
-        }
-      } else {
-        writeln("manifest not found: ", sisudoc_txt_);
-      }
-      auto markup_contents_locations_arr
-        = (cast(char[]) markup_contents_location_).split;
-      auto tmp_dir_ = (sisudoc_txt_).dirName.array;
-      foreach (markup_contents_location; markup_contents_locations_arr) {
-        assert(markup_contents_location.match(rgx.src_pth_sst_or_ssm),
-          "not a recognised file: «" ~
-          markup_contents_location ~ "»"
-        );
-        auto markup_contents_location_pth_ = (markup_contents_location).to!string;
-        Regex!(char) lang_rgx_ = regex(r"/(" ~ _opt_action.languages_set.join("|") ~ ")/");
-        if (_opt_action.languages_set[0] == "all"
-          || (markup_contents_location_pth_).match(lang_rgx_)
-        ) {
-          auto _fns = (((tmp_dir_).chainPath(markup_contents_location_pth_)).array).to!string;
-          _manifested = PathMatters!()(_opt_action, _env, arg, _fns, markup_contents_locations_arr);
-          _manifests ~= _manifested;
-        }
-      }
-    } else if (arg.match(rgx.src_pth_sst_or_ssm)) { /+ markup txt files +/
-      if (exists(arg)==0) {
-        writeln("ERROR >> Processing Skipped! File not found: ", arg);
-      } else {
-        _manifested = PathMatters!()(_opt_action, _env, arg, arg);
-        _manifests ~= _manifested;
-      }
-    } else if (arg.match(rgx.src_pth_zip)) {
-      // fns_src ~= arg;          // gather input markup source file names for processing
-    } else {                      // anything remaining, unused
-      arg_unrecognized ~= " " ~ arg;
-    }
-  }
-}
-#+END_SRC
-
-*** config files load & read
-
-#+NAME: doc_reform_conf_files_in_yaml
-#+BEGIN_SRC d
-{ /+ document config/make file +/
-  auto _config_document_struct = readConfigDoc!()(_manifest, _env);
-  if (_config_document_struct.filetype == "yaml") {
-    import doc_reform.meta.conf_make_meta_yaml;
-    _make_and_meta_struct = _config_document_struct.configParseYAMLreturnDocReformStruct!()(_make_and_meta_struct, _manifest);
-  }
-}
-#+END_SRC
-
-*** opt actions independent of processing files (no files no processing loop)
-
-#+NAME: doc_reform_do_selected
-#+BEGIN_SRC d
-if (!(_opt_action.skip_output)) {
-  if ((_opt_action.debug_do)
-  || (_opt_action.very_verbose)
-  ) {
-    writeln("step0 commence → (without processing files)");
-  }
-  outputHubOp!()(_env, _opt_action);
-  if ((_opt_action.debug_do)
-  || (_opt_action.very_verbose)
-  ) {
-    writeln("- step0 complete");
-  }
-}
-#+END_SRC
-
-** _2. processing: (loop each file)_ [+2]                         :loop:files:
-*** scope (loop)                                                    :scope:
-
-#+NAME: doc_reform_each_file_do_scope
-#+BEGIN_SRC d
-scope(success) {
-  if (!(_opt_action.quiet)) {
-    writefln(
-      "%s",
-      "-- ~ document complete, ok ~ ------------------------------------",
-    );
-  }
-}
-scope(failure) {
-  debug(checkdoc) {
-    stderr.writefln(
-      "~ document run failure ~ (%s  v%s)\n\t%s\n%s",
-      __VENDOR__, __VERSION__,
-      manifest.src.filename,
-      "------------------------------------------------------------------",
-    );
-  }
-}
-enforce(
-  manifest.src.filename.match(rgx.src_pth_types),
-  "not a sisu markup filename: «" ~
-  manifest.src.filename ~ "»"
-);
-#+END_SRC
-
-*** 1. _document abstraction_ [#A]
-
-- return tuple of:
-  - doc_abstraction (the document)
-  - doc_matters
-
-#+NAME: doc_reform_each_file_do_abstraction
-#+BEGIN_SRC d
-if ((_opt_action.debug_do)
-|| (_opt_action.very_verbose)
-) {
-  writeln("--->\nstepX commence → (document abstraction)");
-}
-auto t = DocReformAbstraction!()(_env, program_info, _opt_action, manifest, _make_and_meta_struct);
-static assert(!isTypeTuple!(t));
-static assert(t.length==2);
-auto doc_abstraction = t[dAM.abstraction];
-auto doc_matters = t[dAM.matters];
-if ((doc_matters.opt.action.debug_do)
-|| (doc_matters.opt.action.very_verbose)
-) {
-  writeln("- stepX complete");
-}
-#+END_SRC
-
-*** 2. _output processing_ (post abstraction processing)
-**** 0. abstraction
-***** show document summary - abstraction _print summary_ (to screen) :abstraction:summary:
---show-summary (abstraction summary)
-
-#+NAME: doc_reform_each_file_do_debugs_checkdoc
-#+BEGIN_SRC d
-/+ ↓ debugs +/
-if (doc_matters.opt.action.verbose
-  || doc_matters.opt.action.show_summary
-) {
-  import doc_reform.meta.metadoc_show_summary;
-  DocReformMetaDocSummary!()(doc_abstraction, doc_matters);
-}
-#+END_SRC
-
-***** show metadata (doc headers metadata)
---show-metadata
-
-#+NAME: doc_reform_each_file_do_debugs_checkdoc
-#+BEGIN_SRC d
-/+ ↓ debugs +/
-if (doc_matters.opt.action.show_metadata
-) {
-  import doc_reform.meta.metadoc_show_metadata;
-  DocReformShowMetaData!()(doc_matters);
-}
-#+END_SRC
-
-***** show make (make files & doc headers)
---show-make
-
-#+NAME: doc_reform_each_file_do_debugs_checkdoc
-#+BEGIN_SRC d
-/+ ↓ debugs +/
-if (doc_matters.opt.action.show_make
-) {
-  import doc_reform.meta.metadoc_show_make;
-  DocReformShowMake!()(doc_matters);
-}
-#+END_SRC
-
-***** show config (config files & doc headers)
---show-config
-
-#+NAME: doc_reform_each_file_do_debugs_checkdoc
-#+BEGIN_SRC d
-/+ ↓ debugs +/
-if (doc_matters.opt.action.show_config
-) {
-  import doc_reform.meta.metadoc_show_config;
-  DocReformShowConfig!()(doc_matters);
-}
-#+END_SRC
-
-***** abstraction harvest                           :abstraction:harvest:
-- abstraction harvest
-
-#+NAME: doc_reform_each_file_do_debugs_checkdoc
-#+BEGIN_SRC d
-if (doc_matters.opt.action.harvest) {
-  hvst.harvests ~= DocReformMetaDocHarvest!()(doc_matters, hvst);
-}
-#+END_SRC
-
-**** 1. _debug_ (document parts, checkdoc)                  :debug:checkdoc:
-- [[./meta_output_debugs.org][meta_output_debugs]]
-
-#+NAME: doc_reform_each_file_do_debugs_checkdoc
-#+BEGIN_SRC d
-/+ ↓ debugs +/
-if (doc_matters.opt.action.debug_do) {
-  DocReformDebugs!()(doc_abstraction, doc_matters);
-}
-#+END_SRC
-
-**** 2. _process outputs_                                          :outputs:
-- [[./output_hub.org][output_hub]]
-
-#+NAME: doc_reform_each_file_do_selected_output
-#+BEGIN_SRC d
-/+ ↓ output hub +/
-if (!(doc_matters.opt.action.skip_output)) {
-  if ((_opt_action.debug_do)
-  || (_opt_action.very_verbose)
-  ) {
-    writeln("step5 commence → (process outputs)");
-  }
-  doc_abstraction.outputHub!()(doc_matters);
-  if ((_opt_action.debug_do)
-  || (_opt_action.very_verbose)
-  ) {
-    writeln("- step5 complete");
-  }
-}
-#+END_SRC
-
-*** scope (on loop exit)                                       :scope:exit:
-
-#+NAME: doc_reform_each_file_do_scope_exit
-#+BEGIN_SRC d
-scope(exit) {
-  if (!(_opt_action.quiet)) {
-    writefln(
-      "processed file: %s [%s]",
-      manifest.src.filename,
-      manifest.src.language
-    );
-  }
-  destroy(manifest);
-}
-#+END_SRC
-
-** +2c. no valid filename provided+
-#+NAME: doc_reform_no_filename_provided
-#+BEGIN_SRC d
-/+ no recognized filename provided +/
-writeln("no recognized filename");
-break; // terminate, stop
-#+END_SRC
-
-* 2. pre-processing
-** Output _document abstraction functions_            :module:doc_reform:abstraction:
-*** 0 module template
-- abstraction template
-
-#+BEGIN_SRC d  :tangle "../src/doc_reform/meta/metadoc.d"
-module doc_reform.meta.metadoc;
-template DocReformAbstraction() {
-  <<imports_doc_reform>>
-  <<doc_reform_mixin>>
-  enum headBody { header, body_content, header_type, insert_file_list, image_list }
-  enum makeMeta { make, meta }
-  enum docAbst  { doc_abstract_obj, doc_has }
-  static auto rgx = Rgx();
-  auto DocReformAbstraction(E,P,O,M,S)(
-    E _env,
-    P program_info,
-    O _opt_action,
-    M _manifest,
-    S _make_and_meta_struct
-  ){
-    <<doc_reform_conf_files_in_yaml>>
-    <<doc_reform_each_file_do_read_and_split_dr_markup_file_content_into_header_and_body>>
-    <<doc_reform_each_file_do_split_dr_markup_file_header_into_make_and_meta_structs>>
-    <<doc_reform_each_file_do_document_abstraction>>
-    <<doc_reform_each_file_do_document_matters>>
-    auto t = tuple(doc_abstraction, doc_matters);
-    static assert(t.length==2);
-    return t;
-  }
-}
-#+END_SRC
-
-** Output & Harvest pre-processing
-*** 1. raw file content split, doc: _header_, _content_ +(lists: subdocs? images?)
-- [[./source_read_files.org][source_read_files]] return tuple: header; body; insert file list; image list
-
-- read in the _marked up source document_ and
-  - split the document into:
-    - document header
-    - document body
-      - from markup source
-      - if master document from sub documents content
-  - if a master document
-    - make a list of insert files
-  - if build source pod requested
-    - scan for list of images
-      (action avoided if not needed at this stage)
-
-- _return a tuple of_:
-  - header
-  - body
-  - insert file list
-  - image list (if build source pod requested)
-
-if build source pod requested all information needed to build it available at this point
-  - manifest related information  _manifest
-  - insert file list              _header_body_insertfilelist_imagelist[headBody.insert_file_list]
-  - image list                    _header_body_insertfilelist_imagelist[headBody.image_list]
-
-#+NAME: doc_reform_each_file_do_read_and_split_dr_markup_file_content_into_header_and_body
-#+BEGIN_SRC d
-/+ ↓ read file (filename with path) +/
-/+ ↓ file tuple of header and content +/
-if ((_opt_action.debug_do)
-|| (_opt_action.very_verbose)
-) {
-  writeln("step1 commence → (get document header & body & insert file list & if needed image list)"
-  );
-}
-auto _header_body_insertfilelist_imagelist
-  = DocReformRawMarkupContent!()(_opt_action, _manifest.src.path_and_fn);
-static assert(!isTypeTuple!(_header_body_insertfilelist_imagelist));
-static assert(_header_body_insertfilelist_imagelist.length==5);
-if ((_opt_action.debug_do)
-|| (_opt_action.very_verbose)
-) {
-  writeln("- step1 complete");
-}
-debug(header_and_body) {
-  writeln(header);
-  writeln(_header_body_insertfilelist_imagelist.length);
-  writeln(_header_body_insertfilelist_imagelist.length[headBody.body_content][0]);
-}
-#+END_SRC
-
-*** 2. _document metadata_ & _make instructions_ (struct from yaml)
-- [[./meta_conf_make_meta.org][meta_conf_make_meta]] return tuple: document metadata; make instructions
-
-- read _document header_, split into:
-  - metadata
-  - make instructions
-- read config files
-  - consolidate make instructions
-- _return tuple of_:
-  - document metadata
-  - make instructions (from configuration files & document header make
-    instructions)
-
-#+NAME: doc_reform_each_file_do_split_dr_markup_file_header_into_make_and_meta_structs
-#+BEGIN_SRC d
-/+ ↓ split header into make and meta +/
-if ((_opt_action.debug_do)
-|| (_opt_action.very_verbose)
-) {
-  writeln("step2 commence → (read document header (yaml) return struct)");
-}
-if (_header_body_insertfilelist_imagelist[headBody.header_type] == "yaml") {
-  import doc_reform.meta.conf_make_meta_yaml;
-  _make_and_meta_struct =
-    docHeaderMakeAndMetaTupYamlExtractAndConvertToStruct!()(
-      _header_body_insertfilelist_imagelist[headBody.header],
-      _make_and_meta_struct,
-      _manifest,
-    );
-}
-if ((_opt_action.debug_do)
-|| (_opt_action.very_verbose)
-) {
-  writeln("- step2 complete");
-}
-#+END_SRC
-
-*** 3. _document abstraction, tuple_ (output-pre-processing) [#A]
-- [[./meta_abstraction.org][meta_abstraction]] return tuple: document abstraction; abstraction keys; segnames; image list
-
-- prepare the document abstraction used in downstream processing
-
-- _return tuple of_:
-  - document abstraction (_the_document_ or doc_abstraction)
-  - document abstraction keys
-    - (head, toc, body, endnotes, glossary, bibliography, bookindex, blurb, tail)
-    - (transfer to _doc_matters_)
-  - segnames for html epub (transfer to _doc_matters_)
-  - image list (transfer to _doc_matters_)
-
-#+NAME: doc_reform_each_file_do_document_abstraction
-#+BEGIN_SRC d
-/+ ↓ document abstraction: process document, return abstraction as tuple +/
-if ((_opt_action.debug_do)
-|| (_opt_action.very_verbose)
-) {
-  writeln("step3 commence → (document abstraction (da); da keys; segnames; doc_matters)");
-}
-auto da = DocReformDocAbstraction!()(
-  _header_body_insertfilelist_imagelist[headBody.body_content],
-  _make_and_meta_struct,
-  _opt_action,
-  _manifest,
-  true,
-);
-static assert(!isTypeTuple!(da));
-static assert(da.length==2);
-auto doc_abstraction = da[docAbst.doc_abstract_obj]; /+ head ~ toc ~ body ~ endnotes_seg ~ glossary ~ bibliography ~ bookindex ~ blurb; +/
-auto _doc_has_struct = da[docAbst.doc_has];
-if ((_opt_action.debug_do)
-|| (_opt_action.very_verbose)
-) {
-  writeln("- step3 complete");
-}
-#+END_SRC
-
-*** 4. _document matters_ (doc info gathered, various sources) [#A]
-- gather doc matters
-  - prepare document_matters, miscellany about processing and the document of
-    use in downstream processing
-
-**** verbose message
-
-#+NAME: doc_reform_each_file_do_document_matters
-#+BEGIN_SRC d
-if ((_opt_action.debug_do)
-|| (_opt_action.very_verbose)
-) {
-  writeln("step4 commence → (doc_matters)");
-}
-#+END_SRC
-
-**** DocumentMatters struct {
-
-#+NAME: doc_reform_each_file_do_document_matters
-#+BEGIN_SRC d
-struct DocumentMatters {
-#+END_SRC
-
-**** generator related
-
-#+NAME: doc_reform_each_file_do_document_matters
-#+BEGIN_SRC d
-  auto generator_program() {
-    struct Prog_ {
-      string project_name() {
-        return "DocReform";
-      }
-      string name() {
-        return program_info.name;
-      }
-      string ver() {
-        return program_info.ver;
-      }
-      string name_and_version() {
-        return format(
-          "%s-%s",
-          name,
-          ver,
-        );
-      }
-      string url_home() {
-        return "http://sisudoc.org";
-      }
-      string url_git() {
-        return "https://git.sisudoc.org/software/sisu";
-      }
-      auto compiler() {
-        return program_info.compiler;
-      }
-      auto stime() {
-        return Clock.currTime(UTC()).toSimpleString();
-      }
-    }
-    return Prog_();
-  }
-  auto generated_time() {
-    auto _st = Clock.currTime(UTC());
-    auto _time = _st.year.to!string
-      ~ "-" ~ _st.month.to!int.to!string // prefer as month number
-      ~ "-" ~ _st.day.to!string
-      ~ " [" ~ _st.isoWeek.to!string ~ "/" ~ _st.dayOfWeek.to!int.to!string ~ "]"
-      ~ " " ~ _st.hour.to!string
-      ~ ":" ~ _st.minute.to!string
-      ~ ":" ~ _st.second.to!string;
-    return _time;
-  }
-#+END_SRC
-
-**** config make & meta
-
-#+NAME: doc_reform_each_file_do_document_matters
-#+BEGIN_SRC d
-  auto conf_make_meta() {
-    return _make_and_meta_struct;
-  }
-  auto has() {
-    return _doc_has_struct;
-  }
-#+END_SRC
-
-**** env related
-
-#+NAME: doc_reform_each_file_do_document_matters
-#+BEGIN_SRC d
-  auto env() {
-    struct Env_ {
-      auto pwd() {
-        return _manifest.env.pwd;
-      }
-      auto home() {
-        return _manifest.env.home;
-      }
-    }
-    return Env_();
-  }
-#+END_SRC
-
-**** opt
-
-#+NAME: doc_reform_each_file_do_document_matters
-#+BEGIN_SRC d
-  auto opt() {
-    struct Opt_ {
-      auto action() {
-        /+ getopt options, commandline instructions, raw
-         - processing instructions --epub --html etc.
-         - command line config instructions --output-path
-        +/
-        return _opt_action;
-      }
-    }
-    return Opt_();
-  }
-#+END_SRC
-
-**** output related
-
-#+NAME: doc_reform_each_file_do_document_matters
-#+BEGIN_SRC d
-  auto src() {
-    return _manifest.src;
-  }
-  auto src_path_info() {
-    return DocReformPathsSRC!()(_manifest.env.pwd, _manifest.src.file_with_absolute_path); // would like (to have and use) relative path
-  }
-  auto pod() {
-    return _manifest.pod;
-  }
-  auto sqlite() {
-    struct SQLite_ {
-      string filename() {
-        return _opt_action.sqlite_filename;
-      }
-    }
-    return SQLite_();
-  }
-  auto output_path() {
-    return _make_and_meta_struct.conf.output_path;
-  }
-  auto srcs() {
-    struct SRC_ {
-      auto file_insert_list() {
-        return _header_body_insertfilelist_imagelist[headBody.insert_file_list];
-      }
-      auto image_list() {
-        return _doc_has_struct.imagelist;
-      }
-    }
-    return SRC_();
-  }
-#+END_SRC
-
-**** } close
-
-#+NAME: doc_reform_each_file_do_document_matters
-#+BEGIN_SRC d
-}
-auto doc_matters = DocumentMatters();
-#+END_SRC
-
-**** step complete message
-
-#+NAME: doc_reform_each_file_do_document_matters
-#+BEGIN_SRC d
-if ((_opt_action.debug_do)
-|| (_opt_action.very_verbose)
-) {
-  writeln("- step4 complete");
-}
-#+END_SRC
-
-**** H. abridged doc matters, for harvest (from doc head only, doc abstraction not performed)
-- harvest abridged doc matters gathered
-***** doc matters shared
-
-#+NAME: doc_reform_each_file_do_document_matters_abridged
-#+BEGIN_SRC d
-if ((_opt_action.debug_do)
-|| (_opt_action.verbose)
-) {
-  writeln("step4 commence → (doc_matters)");
-}
-struct DocumentMattersShared {
-  auto env() {
-    struct Env_ {
-      auto pwd() {
-        return _manifest.env.pwd;
-      }
-      auto home() {
-        return _manifest.env.home;
-      }
-    }
-    return Env_();
-  }
-  auto opt() {
-    struct Opt_ {
-      auto action() {
-        return _opt_action;
-      }
-    }
-    return Opt_();
-  }
-}
-DocumentMattersShared doc_matters_shared = DocumentMattersShared();
-#+END_SRC
-
-***** abridged doc matters, for harvest (from doc head only, doc abstraction not performed) TODO
-
-#+NAME: doc_reform_each_file_do_document_matters_abridged
-#+BEGIN_SRC d
-struct DocumentMattersAbridged {
-  auto conf_make_meta() {
-    return _make_and_meta_struct;
-  }
-  auto src() {
-    return _manifest.src;
-  }
-  auto src_path_info() {
-    return DocReformPathsSRC!()(_manifest.env.pwd, _manifest.src.file_with_absolute_path);
-  }
-  auto pod() {
-    return _manifest.pod;
-  }
-  auto sqlite() {
-    struct SQLite_ {
-      string filename() {
-        return _opt_action.sqlite_filename;
-      }
-    }
-    return SQLite_();
-  }
-  auto output_path() {
-    return _make_and_meta_struct.conf.output_path;
-  }
-}
-#+END_SRC
-
-* __END__
-dev notes
-
-** the document notes
-*** document sections (table)
-
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-| section      | part         | opt. |   | objects                                          | ocn                            |   |   |
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-| front matter | head         | *    |   |                                                  | no                             |   |   |
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-| toc          | toc          |      |   | generated from headings                          | no                             |   |   |
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-| body         | body         | *    |   | default section                                  | yes                            |   |   |
-|              |              |      |   | - headings                                       |                                |   |   |
-|              |              |      |   | - paras                                          |                                |   |   |
-|              |              |      |   | - code                                           |                                |   |   |
-|              |              |      |   | - poem                                           |                                |   |   |
-|              |              |      |   | - group                                          |                                |   |   |
-|              |              |      |   | - block                                          |                                |   |   |
-|              |              |      |   | - quote                                          |                                |   |   |
-|              |              |      |   | - table                                          |                                |   |   |
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-| back matter  | endnote      |      |   | generated from inline note markup                | no (each endnote belongs to    |   |   |
-|              |              |      |   |                                                  | a (body) object)               |   |   |
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-|              | glossary     |      |   | identified section, limited markup               | possibly, to make searchable   |   |   |
-|              |              |      |   | - heading                                        | hidden                         |   |   |
-|              |              |      |   | - paras                                          |                                |   |   |
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-|              | bibliography |      |   | generated from inline special markup             | possibly, to make searchable   |   |   |
-|              |              |      |   | appended to paragraphs contained in body section | hidden                         |   |   |
-|              |              |      |   | - heading                                        |                                |   |   |
-|              |              |      |   | - paras                                          |                                |   |   |
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-|              | book index   |      |   | generated from inline special markup             | possibly, special numbering or |   |   |
-|              |              |      |   | - heading                                        | could use term as anchor?      |   |   |
-|              |              |      |   | - paras                                          | to make searchable             |   |   |
-|              |              |      |   |                                                  | hidden                         |   |   |
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-|              | blurb        |      |   | identified section, limited markup               | no (unless non-substantive     |   |   |
-|              |              |      |   | - heading                                        | given special numbering)       |   |   |
-|              |              |      |   | - paras                                          |                                |   |   |
-|--------------+--------------+------+---+--------------------------------------------------+--------------------------------+---+---|
-
-*** document objects (table)
-- check, keep up to date
-
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| doc object       | doc object | attributes              | inline         | appended            | structure            | delimiters                     |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| is_a             | is_of_type |                         |                |                     |                      |                                |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| heading          | para       | - level                 | - font face    | - object number off | - level              | - two newlines                 |
-|                  |            | - object number         | - endnotes     | - book index meta   | (document structure) |                                |
-|                  |            | - object number off     |                |                     |                      |                                |
-|                  |            | - dummy (toc & seg)     |                |                     |                      |                                |
-|                  |            | - tags (internal links) |                |                     |                      |                                |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| toc              | para       | - level                 | - font face    |                     |                      | - auto generated from headings |
-|                  |            | (auto-indent)           | - links (auto) |                     |                      |                                |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| para             | para       | - bullet                | - font face    | - object number off |                      | - two newlines                 |
-|                  |            | - indent                | - links/urls * | - book index meta   |                      |                                |
-|                  |            | - object number         | - images*      |                     |                      |                                |
-|                  |            | - object number off     | - endnotes     |                     |                      |                                |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| bookindex        | para       | - auto indent           | - font face    |                     |                      | - two newlines                 |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| blurb            | para       | - bullet                | - font face    | - object number off |                      | - two newlines                 |
-|                  |            | - indent                | - links/urls * | - book index meta   |                      |                                |
-|                  |            | - object number         | - images*      |                     |                      |                                |
-|                  |            | - object number off     | - endnotes     |                     |                      |                                |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| group            | block      | - object number         | - font face    | - book index meta   | - para break         | - block tags                   |
-|                  |            | - object number off     | - links/urls * |                     |                      | (group)                        |
-|                  |            |                         | - images*      |                     |                      |                                |
-|                  |            |                         | - endnotes     |                     |                      |                                |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| block            | block      | - object number         | - font face    | - book index meta   | - new line           | - block tags                   |
-|                  |            | - object number off     | - links/urls * |                     |                      | (block)                        |
-|                  |            |                         | - images*      |                     |                      |                                |
-|                  |            |                         | - endnotes     |                     |                      |                                |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| quote            | block      | - object number         | - font face    | - book index meta   |                      | - block tags                   |
-|                  |            |                         | - endnotes     |                     |                      | (quote)                        |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| poem (see verse) | block      |                         |                | - book index meta   |                      | - block tags                   |
-|                  |            |                         |                |                     |                      | (poem)                         |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| verse (of poem)  |            | - object number         | - font face    |                     | - new line           | - (see poem delimiter)         |
-|                  |            |                         | - endnotes     |                     | - preceeding spaces  |                                |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| code             | block      | - syntax                |                |                     | - new line           | - block tags                   |
-|                  |            | - numbered              |                |                     | - preceeding spaces  | (code)                         |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| table            | block      | - object number         |                |                     |                      | - block tags (table)           |
-|                  |            |                         |                |                     |                      | (table)                        |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-| endnote          |            |                         | - font face    |                     |                      | (generated from                |
-|                  |            |                         |                |                     |                      | inline markup tags)            |
-|                  |            |                         |                |                     |                      | - two newlines                 |
-|------------------+------------+-------------------------+----------------+---------------------+----------------------+--------------------------------|
-
-- consider special treatment for links/urls (& for images?) take them out of
-  document munge (for various outputs), by storing in own array (within each
-  object struct), and providing info on where in array to extract them from,
-  debating whether necessary or even worthwhile as is extra work
-
-**** check
-
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-|       |              | identified by              | object notes             | attributes     | inline          | embedded       | special    |
-|       |              |                            |                          |                |                 | appended       | characters |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-| para  | heading      | level markers              |                          |                | - italics       | - endnotes     |            |
-|       |              | at start of line           |                          |                |                 | - bibliography |            |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-|       | paragraph    | delimited by two new lines | default object           | - indent       | - bold          | - endnotes     |            |
-|       |              |                            | [discard leading &       | - bullet       | - italics       | - bibliography |            |
-|       |              |                            | newline whitespace]      |                | - underscore    |                |            |
-|       |              |                            |                          |                | - strikethrough |                |            |
-|       |              |                            |                          |                | - superscript   |                |            |
-|       |              |                            |                          |                | - subscript     |                |            |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-| block |              | open and close tags        |                          |                |                 |                |            |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-| TODO  | quote        |                            |                          | - language?    |                 |                |            |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-| TODO  | group        |                            | - inline markup applied  | - language?    | as paragraph    | - endnotes     |            |
-|       |              |                            | - [discard leading &     |                |                 | - bibliography |            |
-|       |              |                            | newline whitespace]      |                |                 |                |            |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-| TODO  | block        |                            | - inline markup applied  |                | as paragraph    | - endnotes     |            |
-|       |              |                            | - whitespace indentation |                |                 | - bibliography |            |
-|       |              |                            | & newlines               |                |                 |                |            |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-|       | poem / verse | open and close tags        | verse is the object      |                |                 | - endnotes     |            |
-|       |              |                            | - inline markup applied  |                |                 | - bibliography |            |
-|       |              | (for poem)                 | - whitespace indentation |                |                 |                |            |
-|       |              |                            | & newlines               |                |                 |                |            |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-|       | code         |                            | - contents untouched     | - syntax       |                 |                |            |
-|       |              |                            | - whitespace indentation | - numbered     |                 |                |            |
-|       |              |                            | & newlines               |                |                 |                |            |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-|       | table        |                            |                          | - column width |                 |                |            |
-|       |              |                            |                          | - heading row  |                 |                |            |
-|-------+--------------+----------------------------+--------------------------+----------------+-----------------+----------------+------------|
-
-*** on abstraction
-
-- abstract for downstream processing
-  - identify document structure and objects
-    - identify document structure (headings/levels/sections)
-    - identify objects (headings, paragraphs, tables, code blocks, verse ...)
-  - set document, generate common abstraction for downstream parsing
-    - set different _document sections_:
-      - _head_, toc, _body_, endnotes, glossary, bibliography, book index, blurb
-    - _object numbers_, heading/ chapter numbering etc, endnote numbers
-      - _regular ocn_
-        - body objects
-        - glossary objects
-        - bibliography objects
-      - _special ocn_
-        - non substantive text (provide special numbers)
-          - blurb objects
-        - book index
-      - special (_exceptions_)
-        - endnotes
-  - unify object representations
-    - multiple markups for same object type given single representation
-  - extract object attributes
-  - unify inline markup on objects
-    - inline markup made easier to identify
-
-- simplify downstream parsing
-
-*** ocn
-
-|-------------+-----------------------+-----------------------+----------------+------|
-| objects     | section / part        | ocn described         | how used       | type |
-|-------------+-----------------------+-----------------------+----------------+------|
-| regular ocn |                       |                       |                |      |
-|-------------+-----------------------+-----------------------+----------------+------|
-|             | body objects          | seq. digit            | anchor         | ocn  |
-|             |                       | [0-9]+                | visible        |      |
-|-------------+-----------------------+-----------------------+----------------+------|
-|             | glossary objects      | seq. digit            | anchor         | ocn  |
-|             |                       | [0-9]+                | not-visible    |      |
-|             |                       |                       | (for search)   |      |
-|-------------+-----------------------+-----------------------+----------------+------|
-|             | bibliography objects  | seq. digit            | anchor         | ocn  |
-|             |                       | [0-9]+                | not-visible    |      |
-|             |                       |                       | (for search)   |      |
-|-------------+-----------------------+-----------------------+----------------+------|
-| special ocn |                       |                       |                |      |
-|-------------+-----------------------+-----------------------+----------------+------|
-|             | non-substantive text  | x char + seq. digit   | anchor         | non  |
-|             | (within body & blurb) | x[0-9]+               | not-visible    |      |
-|             |                       |                       | (for search)   |      |
-|-------------+-----------------------+-----------------------+----------------+------|
-|             | book index            | i char + seq. digit   | anchor         | idx  |
-|             |                       | i[0-9]+               | not-visible    |      |
-|             |                       |                       | (for search)   |      |
-|-------------+-----------------------+-----------------------+----------------+------|
-| without ocn |                       |                       |                |      |
-|-------------+-----------------------+-----------------------+----------------+------|
-|             | endnotes              | ocn of parent object  | no ocn         | fn   |
-|             |                       | + footnote seq. digit | anchor visible |      |
-|-------------+-----------------------+-----------------------+----------------+------|
-
-** doc_reform glossary / terms
-
-|------------+-------------------------------------|
-| doc_reform | sisu document parser                |
-|------------+-------------------------------------|
-| dmso       | document markup, structure, objects |
-|------------+-------------------------------------|
-| meta       | meta document, document abstraction |
-| mda        | meta, meta document abstraction     |
-| adr        | abstract document representation    |
-| dar        | document abstract representation    |
-| (da)       | (document abstraction)              |
-|            | (code representation of document)   |
-|------------+-------------------------------------|
-| ao         | abstract objects                    |
-|            | (code representation of objects)    |
-|------------+-------------------------------------|
-
-consider
-|-------+----------------------------------------------|
-| dao   | document abstraction, objects                |
-|-------+----------------------------------------------|
-| daso  | document abstraction, structure, objects     |
-|-------+----------------------------------------------|
-| drso  | document representation, structure, objects  |
-|-------+----------------------------------------------|
-| daows | document abstraction, objects with structure |
-|-------+----------------------------------------------|
-
-** make config - _composite make_
-
-work on composite make a unification of make instructions for each document run
-
-extract instructions from all config files, unify the make instructions and
-provide the result as a single set of make instructions for each document parsed
-
-- 1. general, document_make config file (to be applied to all documents unless
-  overridden by document or command line instruction)
-- 2. local, site specific (site local instructions such as the site's url, cgi
-  location etc.)
-- 3. each document header, make (the document header contains metadata and may
-  include make instructions for that document)
-  - make
-  - meta
-- 4. command line instruction, make (some make instructions may be passed
-  through the command line)
-
-*** instruction sources
-
-|----+---------------------------------+----------------------------------------+---------------------+---|
-|    | make instruction source         |                                        | varies (applies to) |   |
-|----+---------------------------------+----------------------------------------+---------------------+---|
-| 0. | unify the following as a single | take into account all the instructions |                     |   |
-|    | set of make instructions        | provided below, provide interface      |                     |   |
-|----+---------------------------------+----------------------------------------+---------------------+---|
-| 1. | document_make file              | to be applied to all documents         | per directory       |   |
-|    | "config_document"               | (unless subsequently overridden)       | (all docs within)   |   |
-|----+---------------------------------+----------------------------------------+---------------------+---|
-| 2. | config file                     | local site specific                    | per directory       |   |
-|    | "config_local_site"             |                                        | (all docs within)   |   |
-|----+---------------------------------+----------------------------------------+---------------------+---|
-| 3. | document header make            | make instructions contained            | per document        |   |
-|    |                                 | in document header                     | (single doc)        |   |
-|----+---------------------------------+----------------------------------------+---------------------+---|
-| 4. | command line instruction        | make instruction passed                | each command        |   |
-|    |                                 |                                        | (all docs within)   |   |
-|----+---------------------------------+----------------------------------------+---------------------+---|
-
-*** config & metadata (from instruction sources)
-
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     | 1. document make file    | 2. config file             | 3. document header  | 4. command line instruction |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-| comment, fixed:     | per dir (pod)            | per dir                    | per document (pod)  | per command instruction     |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     | config_document          | config_local_site          |                     |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-| local site specific |                          | *                          |                     | *?                          |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          | webserv                    |                     |                             |
-|                     |                          | - url_root                 |                     |                             |
-|                     |                          | - path                     |                     |                             |
-|                     |                          | - images                   |                     |                             |
-|                     |                          | - cgi                      |                     |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          | webserv_cgi                |                     |                             |
-|                     |                          | - host                     |                     |                             |
-|                     |                          | - base_path                |                     |                             |
-|                     |                          | - port                     |                     |                             |
-|                     |                          | - user                     |                     |                             |
-|                     |                          | - file_links               |                     |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          | processing                 |                     |                             |
-|                     |                          | - path                     |                     |                             |
-|                     |                          | - dir                      |                     |                             |
-|                     |                          | - concord_max              |                     |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          | flag (configure)           |                     | (call)                      |
-|                     |                          | - act0                     |                     | act0                        |
-|                     |                          | - act1                     |                     | act1                        |
-|                     |                          | - act2                     |                     | act2                        |
-|                     |                          | - act3                     |                     | act3                        |
-|                     |                          | - act4                     |                     | act4                        |
-|                     |                          | - act5                     |                     | act5                        |
-|                     |                          | - act6                     |                     | act6                        |
-|                     |                          | - act7                     |                     | act7                        |
-|                     |                          | - act8                     |                     | act8                        |
-|                     |                          | - act9                     |                     | act9                        |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          | default                    |                     |                             |
-|                     |                          | - papersize                |                     |                             |
-|                     |                          | - text_wrap                |                     |                             |
-|                     |                          | - emphasis                 |                     |                             |
-|                     |                          | - language                 |                     |                             |
-|                     |                          | - digest                   |                     |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          | permission                 |                     |                             |
-|                     |                          | - share_source             |                     |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          | program_select             |                     |                             |
-|                     |                          | - editor                   |                     |                             |
-|                     |                          | - epub_viewer              |                     |                             |
-|                     |                          | - html_viewer              |                     |                             |
-|                     |                          | - odf_viewer               |                     |                             |
-|                     |                          | - pdf_viewer               |                     |                             |
-|                     |                          | - xml_viewer               |                     |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          | search                     |                     |                             |
-|                     |                          | - flag                     |                     |                             |
-|                     |                          | - action                   |                     |                             |
-|                     |                          | - db                       |                     |                             |
-|                     |                          | - title                    |                     |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-| make instruction    | **                       | omit or override share?    | **                  | *?                          |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     | make                     | make                       | make                |                             |
-|                     | - bold                   | - bold                     | - bold              |                             |
-|                     | - breaks                 | - breaks                   | - breaks            |                             |
-|                     | - cover_image            | - cover_image              | - cover_image       |                             |
-|                     | - css                    | - css                      | - css               |                             |
-|                     | - emphasis               | - emphasis                 | - emphasis          |                             |
-|                     | - footer                 | - footer                   | - footer            |                             |
-|                     | - headings               | - headings                 | - headings          |                             |
-|                     | - home_button_image      | - home_button_image        | - home_button_image |                             |
-|                     | - home_button_text       | - home_button_text         | - home_button_text  |                             |
-|                     | - italics                | - italics                  | - italics           |                             |
-|                     | - num_top                | - num_top                  | - num_top           |                             |
-|                     | - auto_num_depth         | - auto_num_depth           | - auto_num_depth    |                             |
-|                     | - substitute             | - substitute               | - substitute        |                             |
-|                     | - texpdf_font            | - texpdf_font              | - texpdf_font       |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-| actions             |                          |                            |                     | *                           |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            |                     | assertions                  |
-|                     |                          |                            |                     | concordance                 |
-|                     |                          |                            |                     | debug                       |
-|                     |                          |                            |                     | digest                      |
-|                     |                          |                            |                     | docbook                     |
-|                     |                          |                            |                     | epub                        |
-|                     |                          |                            |                     | html                        |
-|                     |                          |                            |                     | html-seg                    |
-|                     |                          |                            |                     | html-scroll                 |
-|                     |                          |                            |                     | manifest                    |
-|                     |                          |                            |                     | ocn                         |
-|                     |                          |                            |                     | odt                         |
-|                     |                          |                            |                     | pdf                         |
-|                     |                          |                            |                     | postgresql                  |
-|                     |                          |                            |                     | qrcode                      |
-|                     |                          |                            |                     | pod                         |
-|                     |                          |                            |                     | source                      |
-|                     |                          |                            |                     | sqlite                      |
-|                     |                          |                            |                     | sqlite-db-create            |
-|                     |                          |                            |                     | sqlite-db-drop              |
-|                     |                          |                            |                     | text                        |
-|                     |                          |                            |                     | verbose                     |
-|                     |                          |                            |                     | xhtml                       |
-|                     |                          |                            |                     | xml-dom                     |
-|                     |                          |                            |                     | xml-sax                     |
-|                     |                          |                            |                     | section_toc                 |
-|                     |                          |                            |                     | section_body                |
-|                     |                          |                            |                     | section_endnotes            |
-|                     |                          |                            |                     | section_glossary            |
-|                     |                          |                            |                     | section_biblio              |
-|                     |                          |                            |                     | section_bookindex           |
-|                     |                          |                            |                     | section_blurb               |
-|                     |                          |                            |                     | backmatter                  |
-|                     |                          |                            |                     | skip-output                 |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-| metadata            |                          |                            | *                   |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | classify            |                             |
-|                     |                          |                            | - dewey             |                             |
-|                     |                          |                            | - keywords          |                             |
-|                     |                          |                            | - loc               |                             |
-|                     |                          |                            | - subject           |                             |
-|                     |                          |                            | - topic_register    |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | creator             |                             |
-|                     |                          |                            | - author            |                             |
-|                     |                          |                            | - author_email      |                             |
-|                     |                          |                            | - illustrator       |                             |
-|                     |                          |                            | - translator        |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | date                |                             |
-|                     |                          |                            | - added_to_site     |                             |
-|                     |                          |                            | - available         |                             |
-|                     |                          |                            | - created           |                             |
-|                     |                          |                            | - issued            |                             |
-|                     |                          |                            | - modified          |                             |
-|                     |                          |                            | - published         |                             |
-|                     |                          |                            | - valid             |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | identifier          |                             |
-|                     |                          |                            | - isbn              |                             |
-|                     |                          |                            | - oclc              |                             |
-|                     |                          |                            | - pg                |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | links               |                             |
-|                     |                          |                            | - link              |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | notes               |                             |
-|                     |                          |                            | - abstract          |                             |
-|                     |                          |                            | - description       |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | original            |                             |
-|                     |                          |                            | - language          |                             |
-|                     |                          |                            | - source            |                             |
-|                     |                          |                            | - title             |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | publisher           |                             |
-|                     |                          |                            | - name              |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | rights              |                             |
-|                     |                          |                            | - copyright         |                             |
-|                     |                          |                            | - cover             |                             |
-|                     |                          |                            | - illustrations     |                             |
-|                     |                          |                            | - license           |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|
-|                     |                          |                            | title               |                             |
-|                     |                          |                            | - edition           |                             |
-|                     |                          |                            | - full              |                             |
-|                     |                          |                            | - language          |                             |
-|                     |                          |                            | - main              |                             |
-|                     |                          |                            | - note              |                             |
-|                     |                          |                            | - sub               |                             |
-|                     |                          |                            | - subtitle          |                             |
-|---------------------+--------------------------+----------------------------+---------------------+-----------------------------|