path: root/org/output_hub.org

-*- mode: org -*-
#+TITLE:       spine(doc_reform) output hub
#+DESCRIPTION: documents - structuring, publishing in multiple formats & search
#+FILETAGS:    :spine:output:hub:
#+AUTHOR:      Ralph Amissah
#+EMAIL:       [[mailto:ralph.amissah@gmail.com][ralph.amissah@gmail.com]]
#+COPYRIGHT:   Copyright (C) 2015 - 2021 Ralph Amissah
#+LANGUAGE:    en
#+STARTUP:     content hideblocks hidestars noindent entitiespretty
#+OPTIONS:     H:3 num:nil toc:t \n:nil @:t ::t |:t ^:nil _:nil -:t f:t *:t <:t
#+PROPERTY:    header-args  :exports code
#+PROPERTY:    header-args+ :noweb yes
#+PROPERTY:    header-args+ :eval no
#+PROPERTY:    header-args+ :results no
#+PROPERTY:    header-args+ :cache no
#+PROPERTY:    header-args+ :padline no
#+PROPERTY:    header-args+ :mkdirp yes

- [[./spine.org][spine]]  [[./][org/]]

* output hub [#A]
** _module template_ :module:

#+HEADER: :tangle "../src/doc_reform/io_out/hub.d"
#+BEGIN_SRC d
<<doc_header_including_copyright_and_license>>
/++
  output hub<BR>
  check & generate output types requested
+/
module doc_reform.io_out.hub;
template outputHub() {
  <<output_imports>>
  @system void outputHub(D,I)(
    const D doc_abstraction,
    I doc_matters
  ) {
    mixin spineRgxOut;
    mixin Msg;
    auto msg = Msg!()(doc_matters);
    static auto rgx = RgxO();
    enum outTask { source_or_pod, sqlite, sqlite_multi, latex, odt, epub, html_scroll, html_seg, html_stuff }
    void Scheduled(D,I)(int sched, D doc_abstraction, I doc_matters) {
      auto msg = Msg!()(doc_matters);
      <<output_scheduled_task_source_or_pod>>
      <<output_scheduled_task_epub>>
      <<output_scheduled_task_html_meta>>
      <<output_scheduled_task_html_scroll>>
      <<output_scheduled_task_html_seg>>
      <<output_scheduled_task_html_out>>
      <<output_scheduled_task_latex>>
      <<output_scheduled_task_odt>>
      <<output_scheduled_task_sqlite>>
    }
    if (!(doc_matters.opt.action.quiet)) {
      writeln(" ", doc_matters.src.filename_base);
    }
    if (!(doc_matters.opt.action.parallelise_subprocesses)) {
      foreach(schedule; doc_matters.opt.action.output_task_scheduler) {
        Scheduled!()(schedule, doc_abstraction, doc_matters);
      }
    } else {
      import std.parallelism;
      foreach(schedule; parallel(doc_matters.opt.action.output_task_scheduler)) {
        Scheduled!()(schedule, doc_abstraction, doc_matters);
      }
    }
    <<output_shared_sqlite_db>>
  }
}
template outputHubOp() {
  <<output_imports>>
  @system void outputHubOp(E,O,C)(E env, O opt_action, C config) {
    mixin spineRgxOut;
    static auto rgx = RgxO();
    <<output_options_op_sqlite_db_drop>>
    <<output_options_op_sqlite_db_create>>
    <<output_options_op_cgi_search_form_codegen>>
  }
}
#+END_SRC

** initialize / imports

#+NAME: output_imports
#+BEGIN_SRC d
import doc_reform.io_out,
  doc_reform.io_out.metadata,
  doc_reform.io_out.xmls,
  doc_reform.io_out.create_zip_file,
  doc_reform.io_out.paths_output;
#+END_SRC

** outputs
*** files
**** source: _dr_src_ &/or _pod_ :source:pod:
- [[./output_pod.org][output_pod]]

#+NAME: output_scheduled_task_source_or_pod
#+BEGIN_SRC d
if (sched == outTask.source_or_pod) {
  msg.v("spine (doc reform) source processing... ");
  if (doc_matters.opt.action.pod) {
    msg.v("spine (doc reform) source pod processing... ");
  }
  import doc_reform.io_out.source_pod;
  spinePod!()(doc_matters);
  if (doc_matters.opt.action.source) {
    msg.vv("spine (doc reform) source done");
  }
  if (doc_matters.opt.action.pod) {
    msg.vv("spine (doc reform) source pod done");
  }
}
#+END_SRC

**** epub :epub:

#+NAME: output_scheduled_task_epub
#+BEGIN_SRC d
if (sched == outTask.epub) {
  msg.v("epub3 processing... ");
  import doc_reform.io_out.epub3;
  doc_abstraction.outputEPub3!()(doc_matters);
  msg.vv("epub3 done");
}
#+END_SRC

**** html :html:
***** metadata :metadata:

#+NAME: output_scheduled_task_html_meta
#+BEGIN_SRC d
if (sched == outTask.html_stuff) {
  outputMetadata!()(doc_matters);
  msg.vv("html metadata done");
}
#+END_SRC

***** scroll :scroll:

#+NAME: output_scheduled_task_html_scroll
#+BEGIN_SRC d
if (sched == outTask.html_scroll) {
  msg.v("html scroll processing... ");
  import doc_reform.io_out.html;
  outputHTML!().scroll(doc_abstraction, doc_matters);
  msg.vv("html scroll done");
}
#+END_SRC

***** seg :seg:

#+NAME: output_scheduled_task_html_seg
#+BEGIN_SRC d
if (sched == outTask.html_seg) {
  msg.v("html seg processing... ");
  import doc_reform.io_out.html;
  outputHTML!().seg(doc_abstraction, doc_matters);
  msg.vv("html seg done");
}
#+END_SRC

***** css, images etc :css:images:

#+NAME: output_scheduled_task_html_out
#+BEGIN_SRC d
if (sched == outTask.html_stuff) {
  import doc_reform.io_out.html;
  outputHTML!().css(doc_matters);
  outputHTML!().images_cp(doc_matters);
  msg.vv("html css & images done");
}
#+END_SRC

**** latex / pdf :latex:pdf:

#+NAME: output_scheduled_task_latex
#+BEGIN_SRC d
if (sched == outTask.latex) {
  msg.v("latex processing... (available for downstream processing & pdf output");
  import doc_reform.io_out.latex;
  outputLaTeX!()(doc_abstraction, doc_matters);
  msg.vv("latex done");
}
#+END_SRC

**** odf / odt :odf:odt:

#+NAME: output_scheduled_task_odt
#+BEGIN_SRC d
if (sched == outTask.odt) {
  msg.v("odf:odt processing... ");
  import doc_reform.io_out.odt;
  outputODT!()(doc_abstraction, doc_matters);
  msg.vv("odf:odt done");
}
#+END_SRC

**** sqlite discrete :sqlite:

#+NAME: output_scheduled_task_sqlite
#+BEGIN_SRC d
if (sched == outTask.sqlite) {
  msg.v("sqlite processing... ");
  import doc_reform.io_out.sqlite;
  doc_abstraction.SQLiteHubDiscreteBuildTablesAndPopulate!()(doc_matters);
  msg.vv("sqlite done");
}
#+END_SRC

*** db:sql
**** sqlite collection :sqlite:
***** update / populate :update:

#+NAME: output_shared_sqlite_db
#+BEGIN_SRC d
if (doc_matters.opt.action.sqlite_update) {
  msg.v("sqlite update processing...");
  import doc_reform.io_out.sqlite;
  doc_abstraction.SQLiteHubBuildTablesAndPopulate!()(doc_matters);
  msg.vv("sqlite update done");
} else if (doc_matters.opt.action.sqlite_delete) {
  msg.v("sqlite delete processing...");
  import doc_reform.io_out.sqlite;
  doc_abstraction.SQLiteHubBuildTablesAndPopulate!()(doc_matters);
  msg.vv("sqlite delete done");
}
#+END_SRC

***** no markup source files to process
****** drop :drop:

#+NAME: output_options_op_sqlite_db_drop
#+BEGIN_SRC d
if ((opt_action.sqlite_db_drop)) {
  if ((opt_action.verbose)) {
    writeln("sqlite drop db...");
  }
  import doc_reform.io_out.sqlite;
  SQLiteDbDrop!()(opt_action, config);
  if ((opt_action.very_verbose)) {
    writeln("sqlite drop db done");
  }
}
#+END_SRC

****** create :create:

#+NAME: output_options_op_sqlite_db_create
#+BEGIN_SRC d
if ((opt_action.sqlite_db_create)) {
  if ((opt_action.verbose)) {
    auto pth_sqlite_db = spinePathsSQLite!()(opt_action.cgi_sqlite_search_filename, opt_action.output_dir_set);
    writeln("sqlite create table...");
  }
  import doc_reform.io_out.sqlite;
  SQLiteTablesCreate!()(env, opt_action, config);
  if ((opt_action.very_verbose)) {
    writeln("sqlite create table done");
  }
}
#+END_SRC

****  cgi sqlite search form

#+NAME: output_options_op_cgi_search_form_codegen
#+BEGIN_SRC d
if ((opt_action.cgi_search_form_codegen)) {
  if ((opt_action.verbose)) {
    string _sqlite_db_fn = (opt_action.sqlite_filename.empty)
      ? config.conf.w_srv_db_sqlite_filename
      : opt_action.sqlite_filename;
    string _cgi_search_script = (opt_action.cgi_sqlite_search_filename.empty)
      ? config.conf.w_srv_cgi_search_script
      : opt_action.cgi_sqlite_search_filename;
    string _cgi_search_script_raw_fn_d = (opt_action.cgi_sqlite_search_filename_d.empty)
      ? config.conf.w_srv_cgi_search_script_raw_fn_d
      : opt_action.cgi_sqlite_search_filename_d;
    string _cgi_path = (opt_action.output_dir_set.length > 0)
    ? opt_action.output_dir_set
    : (config.conf.w_srv_data_root_path.length > 0)
      ? config.conf.w_srv_data_root_path
      : "";
    auto pth_sqlite_cgi = spinePathsSQLiteCGI!()(_cgi_search_script_raw_fn_d, _cgi_search_script, _cgi_path);
    writeln("sqlite cgi search form...");
    writeln(" ", pth_sqlite_cgi.search_form_path_out);
  }
  import doc_reform.io_out.cgi_sqlite_search_form;
  CGIsearchSQLite!()(env, opt_action, config);
  if ((opt_action.very_verbose)) {
    writeln("sqlite cgi search form done");
  }
}
#+END_SRC

* document header including copyright & license

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

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

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

  - License: AGPL 3 or later:

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

    Copyright (C) Ralph Amissah

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

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

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

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

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

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

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

+/
#+END_SRC

* __END__