From 614e44ad155e693f82a8228897bba2f4869167dd Mon Sep 17 00:00:00 2001
From: Ralph Amissah <ralph.amissah@gmail.com>
Date: Tue, 22 Feb 2022 14:23:35 -0500
Subject: rethink verbose & debug flags, introduce show
---
src/doc_reform/io_out/epub3.d | 30 ++---
src/doc_reform/io_out/html.d | 54 +++------
src/doc_reform/io_out/source_pod.d | 3 +-
src/doc_reform/io_out/sqlite.d | 62 ++++------
src/doc_reform/meta/metadoc.d | 33 +++---
src/doc_reform/meta/metadoc_curate_authors.d | 6 +-
src/doc_reform/meta/metadoc_curate_topics.d | 16 +--
src/doc_reform/spine.d | 165 ++++++++++++++++++---------
8 files changed, 192 insertions(+), 177 deletions(-)
(limited to 'src')
diff --git a/src/doc_reform/io_out/epub3.d b/src/doc_reform/io_out/epub3.d
index 39fcafe..eb5e46a 100644
--- a/src/doc_reform/io_out/epub3.d
+++ b/src/doc_reform/io_out/epub3.d
@@ -365,8 +365,7 @@ template outputEPub3() {
break;
case 8: .. case 9:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a, ": ", obj.metainfo.heading_lev_markup);
writeln(__FILE__, ":", __LINE__, ": ", obj.text);
}
@@ -374,8 +373,7 @@ template outputEPub3() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a, ": ", obj.metainfo.heading_lev_markup);
}
}
@@ -396,8 +394,7 @@ template outputEPub3() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -406,8 +403,7 @@ template outputEPub3() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -425,8 +421,7 @@ template outputEPub3() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -466,8 +461,7 @@ template outputEPub3() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -476,8 +470,7 @@ template outputEPub3() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -520,8 +513,7 @@ template outputEPub3() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -530,8 +522,7 @@ template outputEPub3() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -542,8 +533,7 @@ template outputEPub3() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_epub
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_epub) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_part);
}
}
diff --git a/src/doc_reform/io_out/html.d b/src/doc_reform/io_out/html.d
index 0227de0..2e6d0ad 100644
--- a/src/doc_reform/io_out/html.d
+++ b/src/doc_reform/io_out/html.d
@@ -90,8 +90,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -100,8 +99,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -120,8 +118,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -152,8 +149,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -162,8 +158,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -198,8 +193,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -208,8 +202,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -220,8 +213,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_part);
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
writeln(__FILE__, ":", __LINE__, ": ", obj.text);
@@ -331,8 +323,7 @@ template outputHTML() {
break;
case 8: .. case 9:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a, ": ", obj.metainfo.heading_lev_markup);
writeln(__FILE__, ":", __LINE__, ": ", obj.text);
}
@@ -340,8 +331,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a, ": ", obj.metainfo.heading_lev_markup);
}
}
@@ -361,8 +351,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -371,8 +360,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -390,8 +378,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -430,8 +417,7 @@ template outputHTML() {
doc_html[segment_filename] ~= t[0].to!string;
doc_html_endnotes[segment_filename] ~= t[1];
} else { /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -440,8 +426,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -484,8 +469,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -494,8 +478,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -506,8 +489,7 @@ template outputHTML() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_html
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_html) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_part);
}
}
diff --git a/src/doc_reform/io_out/source_pod.d b/src/doc_reform/io_out/source_pod.d
index 3b21000..4b59116 100644
--- a/src/doc_reform/io_out/source_pod.d
+++ b/src/doc_reform/io_out/source_pod.d
@@ -127,7 +127,8 @@ template spinePod() {
pths_pod.doc_lng(doc_matters.src.filename, doc_matters.src.language).filesystem_open_zpod.mkdirRecurse;
}
}
- debug(pod) {
+ if (doc_matters.opt.action.debug_do_pod
+ && doc_matters.opt.action.verbose) {
writeln(__LINE__, ": ",
doc_matters.src.filename, " -> ",
pths_pod.fn_doc(doc_matters.src.filename, doc_matters.src.language).filesystem_open_zpod
diff --git a/src/doc_reform/io_out/sqlite.d b/src/doc_reform/io_out/sqlite.d
index 3acd39e..7e4d605 100644
--- a/src/doc_reform/io_out/sqlite.d
+++ b/src/doc_reform/io_out/sqlite.d
@@ -172,8 +172,7 @@ template SQLiteDbRun() {
writeln("ERROR SQLite : ", ex);
}
{ /+ debug +/
- if (opt_action.debug_do_sqlite
- && opt_action.verbose) {
+ if (opt_action.debug_do_sqlite) {
writeln(note);
if (opt_action.very_verbose) {
writeln(db_statement);
@@ -221,8 +220,7 @@ template SQLiteFormatAndLoadObject() {
_txt ~= _urls;
}
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(_txt, "\n");
}
}
@@ -265,8 +263,7 @@ template SQLiteFormatAndLoadObject() {
string _urls;
string _txt = _html_font_face(_html_special_characters(obj.text));
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(_txt, "\n");
}
}
@@ -755,8 +752,7 @@ template SQLiteFormatAndLoadObject() {
"html": html_heading(doc_matters, obj)
];
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
debug(sql_txt) {
writeln(obj_txt["text"]);
}
@@ -778,8 +774,7 @@ template SQLiteFormatAndLoadObject() {
"html": html_para(doc_matters, obj)
];
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
debug(sql_txt) {
writeln(obj_txt["text"]);
}
@@ -801,8 +796,7 @@ template SQLiteFormatAndLoadObject() {
"html": html_quote(doc_matters, obj)
];
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
debug(sql_txt) {
writeln(obj_txt["text"]);
}
@@ -824,8 +818,7 @@ template SQLiteFormatAndLoadObject() {
"html": html_group(doc_matters, obj)
];
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
debug(sql_txt) {
writeln(obj_txt["text"]);
}
@@ -847,8 +840,7 @@ template SQLiteFormatAndLoadObject() {
"html": html_block(doc_matters, obj)
];
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
debug(sql_txt) {
writeln(obj_txt["text"]);
}
@@ -870,8 +862,7 @@ template SQLiteFormatAndLoadObject() {
"html": html_verse(doc_matters, obj)
];
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
debug(sql_txt) {
writeln(obj_txt["text"]);
}
@@ -893,8 +884,7 @@ template SQLiteFormatAndLoadObject() {
"html": html_code(obj)
];
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
debug(sql_txt) {
writeln(obj_txt["text"]);
}
@@ -916,8 +906,7 @@ template SQLiteFormatAndLoadObject() {
"html": html_table(doc_matters, obj)
];
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
debug(sql_txt) {
writeln(obj_txt["text"]);
}
@@ -1297,8 +1286,7 @@ template SQLiteInsertDocObjectsLoop() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -1307,8 +1295,7 @@ template SQLiteInsertDocObjectsLoop() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -1332,8 +1319,7 @@ template SQLiteInsertDocObjectsLoop() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -1364,8 +1350,7 @@ template SQLiteInsertDocObjectsLoop() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -1374,8 +1359,7 @@ template SQLiteInsertDocObjectsLoop() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -1404,8 +1388,7 @@ template SQLiteInsertDocObjectsLoop() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
}
}
@@ -1414,8 +1397,7 @@ template SQLiteInsertDocObjectsLoop() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_type);
}
}
@@ -1426,8 +1408,7 @@ template SQLiteInsertDocObjectsLoop() {
break;
default:
{ /+ debug +/
- if (doc_matters.opt.action.debug_do_sqlite
- && doc_matters.opt.action.verbose) {
+ if (doc_matters.opt.action.debug_do_sqlite) {
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_of_part); // check where empty value could come from
writeln(__FILE__, ":", __LINE__, ": ", obj.metainfo.is_a);
writeln(__FILE__, ":", __LINE__, ": ", obj.text); // check where empty value could come from
@@ -1436,7 +1417,10 @@ template SQLiteInsertDocObjectsLoop() {
break;
}
if (obj.metainfo.is_a == "heading") {
- if ((doc_matters.opt.action.very_verbose)) {
+ if (doc_matters.opt.action.show_sqlite) {
+ if (obj.metainfo.heading_lev_markup == 0) {
+ writeln(doc_matters.src.filename);
+ }
writeln(
"markup: ", obj.metainfo.heading_lev_markup,
"> ", obj.metainfo.dom_structure_markedup_tags_status,
diff --git a/src/doc_reform/meta/metadoc.d b/src/doc_reform/meta/metadoc.d
index d8b252e..b912c24 100644
--- a/src/doc_reform/meta/metadoc.d
+++ b/src/doc_reform/meta/metadoc.d
@@ -36,18 +36,17 @@ template spineAbstraction() {
/+ ↓ read file (filename with path) +/
/+ ↓ file tuple of header and content +/
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("step1 commence → (get document header & body & insert file list & if needed image list)"
- );
+ writeln("step1 commence → (get document header & body & insert file list & if needed image list) [", _manifest.src.filename, "]");
}
auto _header_body_insertfilelist_imagelist
= spineRawMarkupContent!()(_opt_action, _manifest.src.path_and_fn);
static assert(_header_body_insertfilelist_imagelist.length==4);
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("- step1 complete");
+ writeln("- step1 complete for [", _manifest.src.filename, "]");
}
debug(header_and_body) {
writeln(header);
@@ -56,9 +55,9 @@ template spineAbstraction() {
}
/+ ↓ split header into make and meta +/
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("step2 commence → (read document header (yaml) return struct)");
+ writeln("step2 commence → (read document header (yaml) return struct) [", _manifest.src.filename, "]");
}
import doc_reform.meta.conf_make_meta_yaml;
_make_and_meta_struct =
@@ -70,15 +69,15 @@ template spineAbstraction() {
_cfg,
);
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("- step2 complete");
+ writeln("- step2 complete for [", _manifest.src.filename, "]");
}
/+ ↓ document abstraction: process document, return abstraction as tuple +/
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("step3 commence → (document abstraction (da); da keys; segnames; doc_matters)");
+ writeln("step3 commence → (document abstraction (da); da keys; segnames; doc_matters) [", _manifest.src.filename, "]");
}
auto da = docAbstraction!()(
_header_body_insertfilelist_imagelist[headBody.body_content],
@@ -91,14 +90,14 @@ template spineAbstraction() {
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)
+ || (_opt_action.debug_do_stages)
) {
- writeln("- step3 complete");
+ writeln("- step3 complete for [", _manifest.src.filename, "]");
}
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("step4 commence → (doc_matters)");
+ writeln("step4 commence → (doc_matters) [", _manifest.src.filename, "]");
}
struct DocumentMatters {
@safe auto generator_program() {
@@ -241,9 +240,9 @@ template spineAbstraction() {
}
auto doc_matters = DocumentMatters();
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("- step4 complete");
+ writeln("- step4 complete for [", _manifest.src.filename, "]");
}
auto t = tuple(doc_abstraction, doc_matters);
return t;
diff --git a/src/doc_reform/meta/metadoc_curate_authors.d b/src/doc_reform/meta/metadoc_curate_authors.d
index f3c1138..16669b2 100644
--- a/src/doc_reform/meta/metadoc_curate_authors.d
+++ b/src/doc_reform/meta/metadoc_curate_authors.d
@@ -454,7 +454,7 @@ string theme_light_1 = format(q"┃
doc_curate.title,
doc_curate.path_html_metadata,
doc_curate.language,
- (_opt_action.very_verbose) ? "\n " ~ doc_curate.path_abs_html_scroll : "",
+ (_opt_action.show_curate_authors) ? "\n " ~ doc_curate.path_abs_html_scroll : "",
);
}
foreach (k; _au.keys.sort) {
@@ -489,9 +489,7 @@ string theme_light_1 = format(q"┃
} catch (ErrnoException ex) {
// Handle error
}
- if (_opt_action.verbose
- || _opt_action.very_verbose
- ) {
+ if (_opt_action.show_curate_authors) {
foreach(_adt; _author_date_title.sort) {
writeln(_adt);
}
diff --git a/src/doc_reform/meta/metadoc_curate_topics.d b/src/doc_reform/meta/metadoc_curate_topics.d
index a8b0db0..07e1a56 100644
--- a/src/doc_reform/meta/metadoc_curate_topics.d
+++ b/src/doc_reform/meta/metadoc_curate_topics.d
@@ -466,7 +466,7 @@ string theme_light_1 = format(q"┃
if (k0 != "_a") {
topics ~= format(q"┃<p class="lev0"><a name="%s" class="lev0">%s</a></p>┃",
k0.translate([' ' : "_"]), k0,) ~ "\n";
- if (_opt_action.very_verbose) {
+ if (_opt_action.show_curate_topics) {
writeln("", k0);
}
if ("_a" in hvst.subject_trees[k0]) {
@@ -495,7 +495,7 @@ string theme_light_1 = format(q"┃
t_a_.path_html_metadata,
t_a_.language,
) ~ "\n";
- if (_opt_action.very_verbose) {
+ if (_opt_action.show_curate_topics) {
writeln("- ", t_a_.title, " - ", t_a_.author);
}
}
@@ -508,7 +508,7 @@ string theme_light_1 = format(q"┃
topics ~= format(q"┃<p class="lev1"><a name="%s.%s" class="lev1">%s</a></p>┃",
k0.translate([' ' : "_"]),
k1.translate([' ' : "_"]), k1,) ~ "\n";
- if (_opt_action.very_verbose) {
+ if (_opt_action.show_curate_topics) {
writeln(" ", k1);
}
if ("_a" in hvst.subject_trees[k0][k1]) {
@@ -537,7 +537,7 @@ string theme_light_1 = format(q"┃
t_a_.path_html_metadata,
t_a_.language,
) ~ "\n";
- if (_opt_action.very_verbose) {
+ if (_opt_action.show_curate_topics) {
writeln(" - ", t_a_.title, " - ", t_a_.author);
}
}
@@ -551,7 +551,7 @@ string theme_light_1 = format(q"┃
topics ~= format(q"┃<p class="lev2"><a name="%s.%s.%s" class="lev2">%s</a></p>┃",
k0.translate([' ' : "_"]), k1.translate([' ' : "_"]),
k2.translate([' ' : "_"]), k2,) ~ "\n";
- if (_opt_action.very_verbose) {
+ if (_opt_action.show_curate_topics) {
writeln(" ", k2);
}
if ("_a" in hvst.subject_trees[k0][k1][k2]) {
@@ -580,7 +580,7 @@ string theme_light_1 = format(q"┃
t_a_.path_html_metadata,
t_a_.language,
) ~ "\n";
- if (_opt_action.very_verbose) {
+ if (_opt_action.show_curate_topics) {
writeln(" - ", t_a_.title, " - ", t_a_.author);
}
}
@@ -594,7 +594,7 @@ string theme_light_1 = format(q"┃
topics ~= format(q"┃<p class="lev3"><a name="%s.%s.%s.%s" class="lev3">%s</a></p>┃",
k0.translate([' ' : "_"]), k1.translate([' ' : "_"]), k2.translate([' ' : "_"]),
k3.translate([' ' : "_"]), k3,) ~ "\n";
- if (_opt_action.very_verbose) {
+ if (_opt_action.show_curate_topics) {
writeln(" ", k3);
}
{
@@ -623,7 +623,7 @@ string theme_light_1 = format(q"┃
t_a_.path_html_metadata,
t_a_.language,
) ~ "\n";
- if (_opt_action.very_verbose) {
+ if (_opt_action.show_curate_topics) {
writeln(" - ", t_a_.title, " - ", t_a_.author);
}
}
diff --git a/src/doc_reform/spine.d b/src/doc_reform/spine.d
index 97cc6b0..91184dc 100755
--- a/src/doc_reform/spine.d
+++ b/src/doc_reform/spine.d
@@ -116,13 +116,18 @@ string program_name = "spine";
"concordance" : false,
"dark" : false,
"debug" : false,
- "debug-pod" : false,
+ "debug-curate" : false,
+ "debug-curate-authors" : false,
+ "debug-curate-topics" : false,
"debug-epub" : false,
"debug-harvest" : false,
"debug-html" : false,
"debug-latex" : false,
"debug-manifest" : false,
+ "debug-metadata" : false,
+ "debug-pod" : false,
"debug-sqlite" : false,
+ "debug-stages" : false,
"digest" : false,
"epub" : false,
"curate" : false,
@@ -148,10 +153,19 @@ string program_name = "spine";
"quiet" : false,
"pod" : false,
"serial" : false,
- "show-summary" : false,
- "show-metadata" : false,
- "show-make" : false,
"show-config" : false,
+ "show-curate" : false,
+ "show-curate-authors" : false,
+ "show-curate-topics" : false,
+ "show-epub" : false,
+ "show-html" : false,
+ "show-latex" : false,
+ "show-make" : false,
+ "show-manifest" : false,
+ "show-metadata" : false,
+ "show-pod" : false,
+ "show-sqlite" : false,
+ "show-summary" : false,
"source" : false,
"sqlite-discrete" : false,
"sqlite-db-create" : false,
@@ -213,14 +227,6 @@ string program_name = "spine";
"curate-authors", "extract info on authors from document header metadata", &opts["curate-authors"],
"curate-topics", "extract info on topics from document header metadata", &opts["curate-topics"],
"dark", "alternative dark theme", &opts["dark"],
- "debug", "debug", &opts["debug"],
- "debug-pod", "debug pod", &opts["debug-pod"],
- "debug-epub", "debug epub", &opts["debug-epub"],
- "debug-harvest", "debug harvest", &opts["debug-harvest"],
- "debug-html", "debug html", &opts["debug-html"],
- "debug-latex", "debug latex", &opts["debug-latex"],
- "debug-manifest", "debug manifest", &opts["debug-manifest"],
- "debug-sqlite", "debug sqlite", &opts["debug-sqlite"],
"digest", "hash digest for each object", &opts["digest"],
"epub", "process epub output", &opts["epub"],
"hide-ocn", "object cite numbers", &opts["hide-ocn"],
@@ -255,8 +261,17 @@ string program_name = "spine";
"serial", "serial processing", &opts["serial"],
"skip-output", "skip output", &opts["skip-output"],
"show-config", "show config", &opts["show-config"],
+ "show-curate", "show curate", &opts["show-curate"],
+ "show-curate-authors", "show curate authors", &opts["show-curate-authors"],
+ "show-curate-topics", "show curate topics", &opts["show-curate-topics"],
+ "show-epub", "show epub", &opts["show-epub"],
+ "show-html", "show html", &opts["show-html"],
+ "show-latex", "show latex", &opts["show-latex"],
"show-make", "show make", &opts["show-make"],
+ "show-manifest", "show manifest", &opts["show-manifest"],
"show-metadata", "show metadata", &opts["show-metadata"],
+ "show-pod", "show pod", &opts["show-pod"],
+ "show-sqlite", "show sqlite", &opts["show-sqlite"],
"show-summary", "show summary", &opts["show-summary"],
"source", "document markup source", &opts["source"],
"set-digest", "default hash digest type (e.g. sha256)", &settings["set-digest"],
@@ -284,6 +299,19 @@ string program_name = "spine";
"workon", "(reserved for some matters under development & testing)", &opts["workon"],
"xhtml", "xhtml output", &opts["xhtml"],
"config", "=/path/to/config/file/including/filename", &settings["config"],
+ "debug", "debug", &opts["debug"],
+ "debug-curate", "debug curate", &opts["debug-curate"],
+ "debug-curate-authors", "debug curate authors", &opts["debug-curate-authors"],
+ "debug-curate-topics", "debug curate topics", &opts["debug-curate-topics"],
+ "debug-epub", "debug epub", &opts["debug-epub"],
+ "debug-harvest", "debug harvest", &opts["debug-harvest"],
+ "debug-html", "debug html", &opts["debug-html"],
+ "debug-latex", "debug latex", &opts["debug-latex"],
+ "debug-manifest", "debug manifest", &opts["debug-manifest"],
+ "debug-metadata", "debug metadata", &opts["debug-metadata"],
+ "debug-pod", "debug pod", &opts["debug-pod"],
+ "debug-sqlite", "debug sqlite", &opts["debug-sqlite"],
+ "debug-stages", "debug stages", &opts["debug-stages"],
// "sqlite-db-filename", "=[filename].sql.db", &settings["sqlite-db-filename"],
);
if (helpInfo.helpWanted) {
@@ -316,20 +344,19 @@ string program_name = "spine";
}
@trusted bool debug_do() {
bool _dbg;
- if (opts["debug"]
- ||opts["debug-epub"]
- ||opts["debug-harvest"]
- ||opts["debug-html"]
- ||opts["debug-latex"]
- ||opts["debug-manifest"]
- ||opts["debug-sqlite"]
- ) {
+ if (opts["debug"]) {
_dbg = true;
} else { _dbg = false; }
return _dbg;
}
- @trusted bool debug_do_pod() {
- return (opts["debug"] || opts["debug-pod"]) ? true : false;
+ @trusted bool debug_do_curate() {
+ return (opts["debug"] || opts["debug-curate"]) ? true : false;
+ }
+ @trusted bool debug_do_curate_authors() {
+ return (opts["debug"] || opts["debug-curate"] || opts["debug-curate-authors"]) ? true : false;
+ }
+ @trusted bool debug_do_curate_topics() {
+ return (opts["debug"] || opts["debug-curate"] || opts["debug-curate-topics"]) ? true : false;
}
@trusted bool debug_do_epub() {
return (opts["debug"] || opts["debug-epub"]) ? true : false;
@@ -346,9 +373,18 @@ string program_name = "spine";
@trusted bool debug_do_manifest() {
return (opts["debug"] || opts["debug-manifest"]) ? true : false;
}
+ @trusted bool debug_do_metadata() {
+ return (opts["debug"] || opts["debug-metadata"]) ? true : false;
+ }
+ @trusted bool debug_do_pod() {
+ return (opts["debug"] || opts["debug-pod"]) ? true : false;
+ }
@trusted bool debug_do_sqlite() {
return (opts["debug"] || opts["debug-sqlite"]) ? true : false;
}
+ @trusted bool debug_do_stages() {
+ return (opts["debug"] || opts["debug-stages"]) ? true : false;
+ }
@trusted bool debug_do_xmls() {
return (opts["debug"] || opts["debug-html"] || opts["debug-epub"]) ? true : false;
}
@@ -409,17 +445,44 @@ string program_name = "spine";
@trusted bool pod() {
return opts["pod"];
}
- @trusted bool show_summary() {
- return opts["show-summary"];
+ @trusted bool show_config() {
+ return opts["show-config"];
+ }
+ @trusted bool show_curate() {
+ return opts["show-curate"];
+ }
+ @trusted bool show_curate_authors() {
+ return (opts["show-curate"] || opts["show-curate-authors"] || opts["verbose"] || opts["very-verbose"]) ? true : false;
+ }
+ @trusted bool show_curate_topics() {
+ return (opts["show-curate"] || opts["show-curate-topics"] || opts["very-verbose"]) ? true : false;
+ }
+ @trusted bool show_epub() {
+ return opts["show-epub"];
+ }
+ @trusted bool show_html() {
+ return opts["show-html"];
+ }
+ @trusted bool show_latex() {
+ return opts["show-latex"];
}
@trusted bool show_make() {
return opts["show-make"];
}
+ @trusted bool show_manifest() {
+ return opts["show-manifest"];
+ }
@trusted bool show_metadata() {
return opts["show-metadata"];
}
- @trusted bool show_config() {
- return opts["show-config"];
+ @trusted bool show_pod() {
+ return opts["show-pod"];
+ }
+ @trusted bool show_sqlite() {
+ return (opts["show-sqlite"] || opts["very-verbose"]) ? true : false;
+ }
+ @trusted bool show_summary() {
+ return (opts["show-summary"] || opts["verbose"] || opts["very-verbose"]) ? true : false;
}
@trusted bool source() {
return opts["source"];
@@ -720,13 +783,13 @@ string program_name = "spine";
}
if (!(_opt_action.skip_output)) {
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
writeln("step0 commence → (without processing files)");
}
outputHubOp!()(_env, _opt_action, _siteConfig);
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
writeln("- step0 complete");
}
@@ -924,23 +987,21 @@ string program_name = "spine";
manifest.src.filename ~ "»"
);
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("--->\nstepX commence → (document abstraction)");
+ writeln("--->\nstepX commence → (document abstraction) [", manifest.src.filename, "]");
}
auto t = spineAbstraction!()(_env, program_info, _opt_action, _cfg, manifest, _make_and_meta_struct);
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)
+ || (_opt_action.debug_do_stages)
) {
- writeln("- stepX complete");
+ writeln("- stepX complete for [", manifest.src.filename, "]");
}
/+ ↓ debugs +/
- if (doc_matters.opt.action.verbose
- || doc_matters.opt.action.show_summary
- ) {
+ if (doc_matters.opt.action.show_summary) {
import doc_reform.meta.metadoc_show_summary;
spineMetaDocSummary!()(doc_abstraction, doc_matters);
}
@@ -968,7 +1029,8 @@ string program_name = "spine";
hvst.curates ~= _hvst;
} else {
if ((doc_matters.opt.action.debug_do)
- || (doc_matters.opt.action.very_verbose)
+ || (_opt_action.debug_do_curate)
+ || (doc_matters.opt.action.very_verbose)
) {
writeln("WARNING curate: document header yaml does not contain information related to: title or author: ", _hvst.path_html_segtoc);
}
@@ -981,15 +1043,15 @@ string program_name = "spine";
/+ ↓ output hub +/
if (!(doc_matters.opt.action.skip_output)) {
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("step5 commence → (process outputs)");
+ writeln("step5 commence → (process outputs) [", manifest.src.filename, "]");
}
doc_abstraction.outputHub!()(doc_matters);
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("- step5 complete");
+ writeln("- step5 complete for [", manifest.src.filename, "]");
}
}
scope(exit) {
@@ -1038,23 +1100,21 @@ string program_name = "spine";
manifest.src.filename ~ "»"
);
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("--->\nstepX commence → (document abstraction)");
+ writeln("--->\nstepX commence → (document abstraction) [", manifest.src.filename, "]");
}
auto t = spineAbstraction!()(_env, program_info, _opt_action, _cfg, manifest, _make_and_meta_struct);
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)
+ || (_opt_action.debug_do_stages)
) {
- writeln("- stepX complete");
+ writeln("- stepX complete for [", manifest.src.filename, "]");
}
/+ ↓ debugs +/
- if (doc_matters.opt.action.verbose
- || doc_matters.opt.action.show_summary
- ) {
+ if (doc_matters.opt.action.show_summary) {
import doc_reform.meta.metadoc_show_summary;
spineMetaDocSummary!()(doc_abstraction, doc_matters);
}
@@ -1082,7 +1142,8 @@ string program_name = "spine";
hvst.curates ~= _hvst;
} else {
if ((doc_matters.opt.action.debug_do)
- || (doc_matters.opt.action.very_verbose)
+ || (_opt_action.debug_do_curate)
+ || (doc_matters.opt.action.very_verbose)
) {
writeln("WARNING curate: document header yaml does not contain information related to: title or author: ", _hvst.path_html_segtoc);
}
@@ -1095,15 +1156,15 @@ string program_name = "spine";
/+ ↓ output hub +/
if (!(doc_matters.opt.action.skip_output)) {
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("step5 commence → (process outputs)");
+ writeln("step5 commence → (process outputs) [", manifest.src.filename, "]");
}
doc_abstraction.outputHub!()(doc_matters);
if ((_opt_action.debug_do)
- || (_opt_action.very_verbose)
+ || (_opt_action.debug_do_stages)
) {
- writeln("- step5 complete");
+ writeln("- step5 complete for [", manifest.src.filename, "]");
}
}
scope(exit) {
--
cgit v1.2.3