nix flake, things nix

1 files changed, 300 insertions, 0 deletions

diff --git a/org/config_d_cfte.org b/org/config_d_cfte.org
new file mode 100644
index 0000000..9bc1bd3
--- /dev/null
+++ b/org/config_d_cfte.org
@@ -0,0 +1,300 @@
+-*- mode: org -*-
+#+TITLE:       configuration d cfte
+#+DESCRIPTION: documents - structuring, various output representations & search
+#+FILETAGS:    :spine: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
+#+PROPERTY:    header-args  :exports code
+#+PROPERTY:    header-args+ :noweb yes
+#+PROPERTY:    header-args+ :results no
+#+PROPERTY:    header-args+ :cache no
+#+PROPERTY:    header-args+ :padline no
+#+PROPERTY:    header-args+ :mkdirp yes
+#+OPTIONS:     H:3 num:nil toc:t \n:t ::t |:t ^:nil -:t f:t *:t
+
+- [[./doc-reform.org][doc-reform.org]]  [[../org/][org/]]
+
+* cfte views version.txt configuration.txt (set version & configuration) SET
+
+** program version: version.txt
+
+*** set program version SET VERSION :version:set:project:
+
+- comma separated numbers: major, minor, patch
+
+#+NAME: spine_version_set
+#+BEGIN_SRC d
+0, 12, 0
+#+END_SRC
+
+*** set program version tangle :version:
+
+#+HEADER: :tangle "../views/version.txt"
+#+HEADER: :noweb yes
+#+BEGIN_SRC txt
+/+ obt - org-mode generated file +/
+struct Version {
+  int major;
+  int minor;
+  int patch;
+}
+enum _ver = Version(<<spine_version_set>>);
+<<spine_compiler_restrictions>>
+#+END_SRC
+
+*** compilation restrictions (supported compilers)
+- set compilation restrictions
+
+https://dlang.org/spec/version.html#predefined-versions
+
+#+NAME: spine_compiler_restrictions
+#+HEADER: :noweb yes
+#+BEGIN_SRC d
+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
+
+** set configuration SET :configuration:
+
+SEE NOTES on configuration hierarchy in spine.org
+
+*** spine: configuration.txt SET
+**** example
+
+#+HEADER: :tangle "../views/configuration_example.txt"
+#+HEADER: :noweb yes
+#+BEGIN_SRC d
+/+ obt - org-mode generated file +/
+struct Cfg {
+  string http_request_type     = "http";
+  string http_host             = "localhost";
+  string www_url_doc_subroot   = "/spine";
+  string cgi_filename          = "spine_search";
+  string cgi_search_form_title = "≅ SiSU Spine search";
+  string db_sqlite_path        = "/var/www/sqlite";
+  string db_sqlite_filename    = "spine.search.db";
+}
+enum _cfg = Cfg();
+#+END_SRC
+
+#+BEGIN_SRC d
+/+ obt - org-mode generated file +/
+struct Cfg {
+  string http_request_type        = "<<http_request_type>>";
+  string http_host                = "<<http_host>>";
+  string www_url_doc_root         = "<<www_url_doc_root>>";
+  string www_url_doc_subroot      = "<<www_url_doc_subroot>>";
+  string processing_path_doc_root = "<<processing_path_doc_root>>";
+  string cgi_bin_root             = "<<cgi_bin_root>>";
+  string cgi_bin_subpath          = "<<cgi_bin_subpath>>";
+  string cgi_filename             = "<<cgi_filename>>";
+  string cgi_url_root             = "<<http_request_type>>://<<http_host>><<cgi_bin_subpath>>";
+  string cgi_port                 = "";
+  string cgi_user                 = "";
+  string cgi_url_action           = "<<http_request_type>>://<<http_host>><<cgi_bin_subpath>>/<<cgi_filename>>";
+  string cgi_search_form_title    = "<<cgi_search_form_title>>";
+  string db_sqlite_path           = "<<db_sqlite_path>>";
+  string db_sqlite_filename       = "<<db_sqlite_filename>>";
+  string default_language         = "en";
+  string default_papersize        = "a4,letter.portrait";
+  string default_text_wrap        = "80";
+  string default_hash_digest      = "sha256";
+}
+enum _cfg = Cfg();
+#+END_SRC
+
+**** configure
+
+#+HEADER: :tangle ../views/configuration.txt_
+#+HEADER: :noweb yes
+#+BEGIN_SRC d
+<<config_localhost>>
+#+END_SRC
+
+**** configure remote host (sisudoc.org)
+
+#+NAME: config_remotehost
+#+HEADER: :tangle ../views/configuration.txt_remotehost_
+#+BEGIN_SRC d
+struct Cfg {
+  string http_request_type     = "https";
+  string http_host             = "sisudoc.org";
+  string www_url_doc_subroot   = "/spine";
+  string cgi_filename          = "spine_search";
+  string cgi_search_form_title = "≅ SiSU Spine search";
+  string db_sqlite_path        = "/var/www/sqlite";
+  string db_sqlite_filename    = "spine.search.db";
+}
+enum _cfg = Cfg();
+#+END_SRC
+
+#+BEGIN_SRC d
+struct Cfg {
+  string http_request_type        = "https";
+  string http_host                = "sisudoc.org";
+  string www_url_doc_root         = "https://sisudoc.org";
+  string www_url_doc_subroot      = "/spine";
+  string processing_path_doc_root = "/srv/www/spine";
+  string cgi_bin_root             = "/var/www/cgi/cgi-bin";
+  string cgi_bin_subpath          = "";
+  string cgi_filename             = "spine_search";
+  string cgi_url_root             = "https://sisudoc.org";
+  string cgi_port                 = "";
+  string cgi_user                 = "";
+  string cgi_url_action           = "https://sisudoc.org/spine_search";
+  string cgi_search_form_title    = "≅ SiSU Spine search";
+  string db_sqlite_path           = "/var/www/sqlite";
+  string db_sqlite_filename       = "spine.search.db";
+  string default_language         = "en";
+  string default_papersize        = "a4";
+  string default_text_wrap        = "80";
+  string default_hash_digest      = "sha256";
+}
+enum _cfg = Cfg();
+#+END_SRC
+
+**** configure localhost
+
+#+NAME: config_localhost
+#+HEADER: :tangle ../views/configuration.txt_localhost_
+#+BEGIN_SRC d
+struct Cfg {
+  string http_request_type     = "http";
+  string http_host             = "localhost";
+  string www_url_doc_subroot   = "/spine";
+  string cgi_filename          = "spine_search";
+  string cgi_search_form_title = "≅ SiSU Spine search";
+  string db_sqlite_path        = "/var/www/sqlite";
+  string db_sqlite_filename    = "spine.search.db";
+}
+enum _cfg = Cfg();
+#+END_SRC
+
+#+BEGIN_SRC d
+struct Cfg {
+  string http_request_type        = "http";
+  string http_host                = "localhost";
+  string www_url_doc_root         = "http://localhost";
+  string www_url_doc_subroot      = "/spine";
+  string processing_path_doc_root = "/srv/www/spine";
+  string cgi_bin_root             = "/var/www/cgi/cgi-bin";
+  string cgi_bin_subpath          = "/cgi-bin";
+  string cgi_filename             = "spine_search";
+  string cgi_url_root             = "http://localhost/cgi-bin";
+  string cgi_port                 = "";
+  string cgi_user                 = "";
+  string cgi_url_action           = "http://localhost/cgi-bin/spine_search";
+  string cgi_search_form_title    = "≅ SiSU Spine search";
+  string db_sqlite_path           = "/var/www/sqlite";
+  string db_sqlite_filename       = "spine.search.db";
+  string default_language         = "en";
+  string default_papersize        = "a4,letter.portrait";
+  string default_text_wrap        = "80";
+  string default_hash_digest      = "sha256";
+}
+enum _cfg = Cfg();
+#+END_SRC
+
+*** spine_search: configuration.txt SET
+
+#+HEADER: :tangle "../doc-reform-code-software-search-cgi/views/configuration_example.txt"
+#+HEADER: :noweb yes
+#+BEGIN_SRC d
+/+ obt - org-mode generated file +/
+struct Cfg {
+  string http_request_type     = "<<http_request_type>>";
+  string http_host             = "<<http_host>>";
+  string www_url_doc_subroot   = "<<www_doc_subroot>>";
+  string cgi_filename          = "<<cgi_filename>>";
+  string cgi_search_form_title = "<<cgi_search_form_title>>";
+  string db_sqlite_path        = "<<db_sqlite_path>>";
+  string db_sqlite_filename    = "<<db_sqlite_filename>>";
+}
+enum _cfg = Cfg();
+#+END_SRC
+
+#+BEGIN_SRC d
+struct Cfg {
+  string http_request_type     = "https";
+  string http_host             = "sisudoc.org";
+  string www_url_doc_subroot   = "/spine";
+  string cgi_filename          = "spine_search";
+  string cgi_search_form_title = "≅ SiSU Spine search";
+  string db_sqlite_path        = "/var/www/sqlite";
+  string db_sqlite_filename    = "spine.search.db";
+}
+enum _cfg = Cfg();
+#+END_SRC
+
+*** shared settings SET defaults
+
+#+NAME: http_request_type
+#+BEGIN_SRC sh
+http
+#+END_SRC
+
+#+NAME: http_host
+#+BEGIN_SRC sh
+localhost
+#+END_SRC
+
+#+NAME: www_url_doc_root
+#+BEGIN_SRC sh
+http://localhost
+#+END_SRC
+
+#+NAME: www_url_doc_subroot
+#+BEGIN_SRC sh
+/spine
+#+END_SRC
+
+#+NAME: processing_path_doc_root
+#+BEGIN_SRC sh
+/srv/www/spine
+#+END_SRC
+
+#+NAME: www_doc_subroot
+#+BEGIN_SRC sh
+/spine
+#+END_SRC
+
+#+NAME: cgi_bin_root
+#+BEGIN_SRC sh
+/var/www/cgi/cgi-bin
+#+END_SRC
+
+#+NAME: db_sqlite_path
+#+BEGIN_SRC sh
+/var/www/sqlite
+#+END_SRC
+
+#+NAME: cgi_filename
+#+BEGIN_SRC sh
+spine_search
+#+END_SRC
+
+#+NAME: cgi_bin_subpath
+#+BEGIN_SRC sh
+/cgi-bin
+#+END_SRC
+
+#+NAME: cgi_search_form_title
+#+BEGIN_SRC sh
+≅ SiSU Spine search
+#+END_SRC
+
+#+NAME: db_sqlite_filename
+#+BEGIN_SRC sh
+spine.search.db
+#+END_SRC