-*- 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 - 2022 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.sqliteDB_filename.empty) ? config.conf.w_srv_db_sqlite_filename : opt_action.sqliteDB_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 - 2022 Ralph Amissah, All Rights Reserved. - License: AGPL 3 or later: Spine (SiSU), a framework for document structuring, publishing and search Copyright (C) Ralph Amissah This program is free software: you can redistribute it and/or modify it under the terms of the GNU AFERO General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see [https://www.gnu.org/licenses/]. If you have Internet connection, the latest version of the AGPL should be available at these locations: [https://www.fsf.org/licensing/licenses/agpl.html] [https://www.gnu.org/licenses/agpl.html] - Spine (by Doc Reform, related to SiSU) uses standard: - docReform markup syntax - standard SiSU markup syntax with modified headers and minor modifications - docReform object numbering - standard SiSU object citation numbering & system - Homepages: [https://www.doc_reform.org] [https://www.sisudoc.org] - Git [https://git.sisudoc.org/projects/?p=software/spine.git;a=summary] +/ #+END_SRC * __END__