nixify, enable nix install sisu for use here

- enable nix install sisu for use on document
  samples

10 files changed, 2212 insertions, 16 deletions

diff --git a/.env/echo-nixNote b/.env/echo-nixNote
new file mode 100644
index 0000000..ad8717f
--- /dev/null
+++ b/.env/echo-nixNote
@@ -0,0 +1,239 @@
+echo '-*- mode: org -*-
+
+* nixpkgs path?
+
+  # eval "$(nix print-dev-env)"
+' > nixNote_.org
+
+echo "  <nixpkgs> == `nix-instantiate --find-file nixpkgs`" >> nixNote_.org
+
+echo '
+* nix build and show derivation
+
+#+BEGIN_SRC sh
+nix-shell --pure
+
+nix-build
+nix build -f default.nix --print-build-logs
+nix shell -f default.nix --print-build-logs
+nix develop --build -f derivation.nix -I .envrc --print-build-logs
+
+nix-instantiate | nix-build
+
+nix-instantiate -I .envrc | nix-build -I .envrc
+nix build `nix-instantiate`
+nix build `nix-instantiate -I .envrc`
+
+nix develop
+
+nix-instantiate | nix show-derivation | jq
+nix-instantiate -I .envrc | nix show-derivation -f derivation.nix -I .envrc | jq
+
+nix-instantiate | nix show-derivation --recursive | jq
+nix-instantiate -I .envrc | nix show-derivation -f derivation.nix --recursive -I .envrc | jq
+
+nix search --json 2>/dev/null |jq
+#+END_SRC
+
+* version and build info
+
+#+BEGIN_SRC sh' >> nixNote_.org
+
+echo 'spine version (git) == $SpineVER' >> nixNote_.org
+echo "spine version (git) == $SpineVER" >> nixNote_.org
+echo 'nix-instantiate == `nix-instantiate`' >> nixNote_.org
+echo "nix-instantiate == `nix-instantiate`" >> nixNote_.org
+
+echo "#+END_SRC
+
+* initialised shell variables
+
+#+BEGIN_SRC sh
+SpineSRC=$SpineSRC
+SpineDOC=$SpineDOC
+SpinePOD=$SpinePOD
+SpineOUTversioned=$SpineOUTversioned
+SpineOUT=$SpineOUT
+#+END_SRC
+" >> nixNote_.org
+
+echo '* spine run instruction examples
+** parallelized tasks
+*** doc source
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --pod --source --output="$SpineOUTversioned" $SpinePOD/*
+#+END_SRC
+
+*** html & epub output
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --html --epub --output="$SpineOUTversioned" $SpinePOD/*
+#+END_SRC
+
+*** sqlite db for each document - populate each db
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-discrete --output="$SpineOUTversioned" $SpinePOD/*
+#+END_SRC
+
+*** doc source; html, epub; sqlite outputs
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --verbose --pod --html --epub --sqlite-discrete --output="$SpineOUTversioned" $SpinePOD/*
+#+END_SRC
+
+*** curate (authors topics)
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --curate --output="$SpineOUTversioned" $SpinePOD/*
+#+END_SRC
+
+*** html, curate
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --verbose --dark --html --html-link-curate --curate --output="$SpineOUTversioned" $SpinePOD/*
+$SpineBIN/spine --very-verbose --html --html-link-curate --curate --output="$SpineOUTversioned" $SpinePOD/*
+#+END_SRC
+
+*** composite command: source pod, html, epub, curate, sqlite
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --verbose --dark --pod --epub --html --html-link-curate --curate --sqlite-discrete --output="$SpineOUTversioned" $SpinePOD/*
+#+END_SRC
+
+** sequential tasks
+*** sqlite db (shared) - create db
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-db-create --output="$SpineOUTversioned"
+#+END_SRC
+
+*** sqlite db (shared) - populate db
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-update --output="$SpineOUTversioned" $SpineDOC/spine-markup-samples/markup/pod/*
+#+END_SRC
+
+*** sqlite db (shared) - drop db
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-db-drop --output="$SpineOUTversioned"
+#+END_SRC
+
+*** sqlite db (shared) - create & populate db (single step)
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-db-create --sqlite-update --output="$SpineOUTversioned" $SpinePOD/*
+#+END_SRC
+
+*** composite command: source pod, html, epub, curate, sqlite
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --verbose --no-parallel --dark --pod --epub --html --html-link-curate --curate --sqlite-discrete --output="$SpineOUTversioned" $SpinePOD/*
+#+END_SRC
+
+** config [./pod/].dr/config_local_site
+
+#+BEGIN_SRC sh
+cat $SpinePOD/.dr/config_local_site
+$SpineBIN/spine --show-config $SpinePOD
+$SpineBIN/spine --show-config --output="$SpineOUTversioned" $SpinePOD
+#+END_SRC
+
+** cgi operations (output to $SpineOUT /var/www)
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-db-create --output="$SpineOUT" $SpinePOD/*
+
+$SpineBIN/spine -v --cgi-search-form-codegen --output=$SpineOUT $SpinePOD/*
+
+$SpineBIN/spine -v --show-config --config=$SpinePOD/.dr
+
+$SpineBIN/spine --html $SpinePOD/*
+
+
+$SpineBIN/spine -v --cgi-search-form-codegen --config=$SpinePOD/.dr/config_local_site
+#+END_SRC
+
+*** generate html linked to search form
+
+#+BEGIN_SRC sh
+$SpineBIN/spine -v --html --html-link-search --html-link-curate --curate  --output=$SpineOUT $SpinePOD/*
+#+END_SRC
+
+*** create or re-create sql db (--sqlite-db-create or --sqlite-db-recreate)
+
+#+BEGIN_SRC sh
+$SpineBIN/spine -v --sqlite-db-create --sqlite-db-filename="spine.search.db" --sqlite-db-path="$SpineDBpath"
+$SpineBIN/spine -v --sqlite-db-recreate --sqlite-db-filename="spine.search.db" --sqlite-db-path="$SpineDBpath"
+#+END_SRC
+
+*** populate sqlite db
+
+#+BEGIN_SRC sh
+$SpineBIN/spine -v --sqlite-update --sqlite-db-filename="spine.search.db" --output=$SpineOUT $SpinePOD/*
+#+END_SRC
+
+*** generate html (linked to search form), sql output, curate COMPOSITE
+
+#+BEGIN_SRC sh
+$SpineBIN/spine -v --html --html-link-search --html-link-curate --curate --sqlite-update --sqlite-db-filename="spine.search.db" --cgi-sqlite-search-filename="spine_search" --sqlite-db-path="$SpineDBpath" --output="$SpineOUT" $SpinePOD/*
+$SpineBIN/spine --epub --html --html-link-search --html-link-curate --curate --sqlite-update --sqlite-db-filename="spine.search.db" --cgi-sqlite-search-filename="spine_search" --cgi-url-action="https://sisudoc.org/spine_search" --ouput="$SpineOUT" $SpinePOD/*
+#+END_SRC
+
+*** generate html (linked to search form), sql output, curate COMPOSITE with resource configuration
+
+if names and paths are configured in resource configuration file, e.g. $SpinePOD/.rc/config_local_site
+
+#+BEGIN_SRC sh
+$SpineBIN/spine -v --html --html-link-search --html-link-curate --curate --sqlite-update $SpinePOD/*
+#+END_SRC
+
+#+BEGIN_SRC yaml
+# sample resource configuration file ( $SpinePOD/.rc/config_local_site )
+output:
+  path:                        "/srv/www/spine"
+default:
+  language:                    "en"
+  papersize:                   "a4"
+  text_wrap:                   "80"
+  digest:                      "sha256"
+webserv:
+  http:                        "http"
+  domain:                      "localhost"
+  data_http:                   "http"
+  data_domain:                 "localhost"
+  data_root_url:               "https://sisudoc.org"
+  data_root_path:              "/srv/www/spine"
+  images_root_part:            "image"
+  cgi_search_form_title:       "≅ SiSU Spine search"
+  cgi_http:                    "https"
+  cgi_domain:                  "sisudoc.org"
+  cgi_bin_url:                 "http://sisudoc.org/cgi-bin"
+  cgi_bin_part:                "cgi-bin"
+  cgi_bin_path:                "/var/www/cgi/cgi-bin"
+  cgi_search_script:           "spine_search"
+  cgi_action:                  "https://sisudoc.org/spine_search"
+  db_sqlite_filename:          "spine.search.db"
+  db_sqlite_path:              "/var/www/sqlite"
+#+END_SRC
+
+*** make search form
+
+#+BEGIN_SRC sh
+$SpineBIN/spine -v --cgi-search-form-codegen --config=$SpinePOD/.dr/config_local_site
+#+END_SRC
+
+*** latex
+
+#+BEGIN_SRC sh
+$SpineBIN/spine --latex --serial --output="$SpineOUT" $SpinePOD/*
+ls $SpineOutstatic/latex/*.tex
+#+END_SRC
+' >> nixNote_.org
+
+#cat nixNote_.org
+
+#echo "emacs nixNote_.org"
+#echo "cat nixNote_.org"
diff --git a/.env/nix-commands b/.env/nix-commands
new file mode 100644
index 0000000..7cfa723
--- /dev/null
+++ b/.env/nix-commands
@@ -0,0 +1,20 @@
+- nix flake update && nix flake check --show-trace && nix flake show && nix develop .#devShell
+
+- nix build .#default --print-build-logs
+- nix build .#spine-dmd --print-build-logs
+- nix build .#spine-ldc --print-build-logs
+- nix build .#spine-gdc --print-build-logs
+
+- nix develop
+  - nix develop .#devShell --print-build-logs
+  - nix develop .#devShell-html --print-build-logs
+  - nix develop .#devShell-epub --print-build-logs
+  - nix develop .#devShell-latex-pdf --print-build-logs
+  - nix develop .#devShell-sqlite --print-build-logs
+  - nix develop .#devShell-i18n --print-build-logs
+
+nix run .#default --print-build-logs
+
+nix develop --build .#default --print-build-logs
+
+nix-shell '<nixpkgs>' -A nix --pure
diff --git a/.envrc b/.envrc
new file mode 100644
index 0000000..f053b70
--- /dev/null
+++ b/.envrc
@@ -0,0 +1,15 @@
+use flake .
+#use flake .#default
+NIX_ENFORCE_PURITY=1
+NixDirEnvVersion="2.2.1"
+if ! has nix_direnv_version || ! nix_direnv_version ${NixDirEnvVersion}; then
+# - https://github.com/nix-community/nix-direnv
+# source_url "https://raw.githubusercontent.com/nix-community/nix-direnv/${NixDirEnvVersion}/direnvrc" "sha256-0000000000000000000000000000000000000000000="
+  source_url "https://raw.githubusercontent.com/nix-community/nix-direnv/${NixDirEnvVersion}/direnvrc" "sha256-zelF0vLbEl5uaqrfIzbgNzJWGmLzCmYAkInj/LNxvKs="
+fi
+watch_file flake.lock
+watch_file flake.nix
+if [ -f .envrc-local ]; then
+  source_env_if_exists .envrc-local || source .envrc-local
+fi
+#nix flake update && nix flake check --show-trace && nix flake show
diff --git a/.gitignore b/.gitignore
index 327d5c6..d8fecda 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,36 @@
 # git ls-files --others --exclude-from=.git/info/exclude
+# git check-ignore -v flake.lock
+# git clean -ix
+# find . -name "*_" | xargs rm -rf
+*
+!nix/**
+!*.nix
+!flake.lock
+!.envrc
+!.env
+!.env/**
+!README
+!COPYRIGHT
+!CHANGELOG
+!makefile
+!version.txt
+!configuration.txt
+!conf/
+!conf/**
+!*.json
+!tangle
+!*.org
+!org/
+!org/*.org
+!*.rb
+!*.sst
+!*.ssm
+!*.ssi
+!**/*.sst
+!**/*.ssm
+!**/*.ssi
+!data
+!data/**
 *~
 *_
 \#*
@@ -9,7 +41,13 @@
 *.gemspec
 *_.rb
 *.rb_
-.pc
 0???-*.patch
 *.gz
 *.xz
+*_
+.*
+!.gitignore
+!.gitattributes
+!.envrc
+!.env
+!.env/**
diff --git a/README b/README
index b83a522..c7ce091 100644
--- a/README
+++ b/README
@@ -1,29 +1,40 @@
+-*- mode: org -*-
+
+* what is this
+
 These are samples of documents for use by SiSU prepared with SiSU markup
-markup samples in sisu-markup-samples are installed to
-/usr/share/doc/markup-samples
+
+the current versions are contained in the sub-directory:
+
+./data/samples/current/en/
+
+* To install sisu using nix (flake)
+
+nix flake update
+nix flake show
+nix build . --print-build-logs
+
+nix develop .#devShell --print-build-logs -c zsh
+
+* To run sisu against sisu-markup samples
 
 Output in multiple formats can be generated running SiSU against the markup
-samples, e.g.:
+samples, e.g. you could try:
+
+sisu -v --html ./data/samples/current/en/the_wealth_of_networks.yochai_benkler.sst
+sisu -v --html --epub ./data/samples/current/en/the_wealth_of_networks.yochai_benkler.sst
 
-sisu --html filename.sst
-sisu --html --epub --pdf filename.sst
+sisu --html ./data/samples/current/en/*
 
 see:
-  man sisu
   <http://www.sisudoc.org>
-  <http://www.jus.uio.no/sisu>
-
-On Debian:
-
-(a) the lines to add for the upstream archive in /etc/apt/sources.list are:
 
-  deb http://www.jus.uio.no/sisu/archive unstable main non-free
-  deb-src http://www.jus.uio.no/sisu/archive unstable main non-free
+* On Debian
 
-(b) this package is placed in non-free, as the documents are released under the
+(a) this package is placed in non-free, as the documents are released under the
 author or original publisher's license, and the substantive texts of the
 document is to be kept un-altered, which falls outside the Debian Free Software
 Guidelines
 
-(c) this package would be placed in /usr/share/doc/sisu-markup-samples
+(b) this package would be placed in /usr/share/doc/sisu-markup-samples
 as reference material on how to markup documents
diff --git a/flake.lock b/flake.lock
new file mode 100644
index 0000000..44748df
--- /dev/null
+++ b/flake.lock
@@ -0,0 +1,80 @@
+{
+  "nodes": {
+    "flake-utils": {
+      "locked": {
+        "lastModified": 1667395993,
+        "narHash": "sha256-nuEHfE/LcWyuSWnS8t12N1wc105Qtau+/OdUAjtQ0rA=",
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "rev": "5aed5285a952e0b949eb3ba02c12fa4fcfef535f",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "type": "github"
+      }
+    },
+    "flake-utils_2": {
+      "locked": {
+        "lastModified": 1667395993,
+        "narHash": "sha256-nuEHfE/LcWyuSWnS8t12N1wc105Qtau+/OdUAjtQ0rA=",
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "rev": "5aed5285a952e0b949eb3ba02c12fa4fcfef535f",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1675758091,
+        "narHash": "sha256-7gFSQbSVAFUHtGCNHPF7mPc5CcqDk9M2+inlVPZSneg=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "747927516efcb5e31ba03b7ff32f61f6d47e7d87",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixpkgs-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "flake-utils": "flake-utils",
+        "nixpkgs": "nixpkgs",
+        "sisu": "sisu"
+      }
+    },
+    "sisu": {
+      "inputs": {
+        "flake-utils": "flake-utils_2",
+        "nixpkgs": [
+          "nixpkgs"
+        ]
+      },
+      "locked": {
+        "lastModified": 1675891915,
+        "narHash": "sha256-Kcdil+n80D5xCQp1TRXrNiVid7e1Ryqei/sXLLVeE9o=",
+        "ref": "refs/heads/upstream",
+        "rev": "615892da80afb671040c8be5d89430ae2fafe180",
+        "revCount": 2029,
+        "type": "git",
+        "url": "git://git.sisudoc.org/software/sisu"
+      },
+      "original": {
+        "type": "git",
+        "url": "git://git.sisudoc.org/software/sisu"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}
diff --git a/flake.nix b/flake.nix
new file mode 100644
index 0000000..d259bd1
--- /dev/null
+++ b/flake.nix
@@ -0,0 +1,188 @@
+{
+  description                  = "sisu parser & document generator";
+  inputs = {
+    nixpkgs.url                = "github:NixOS/nixpkgs/nixpkgs-unstable"; # "github:nixos/nixpkgs";
+    flake-utils.url            = "github:numtide/flake-utils";
+    sisu.url                  = "git://git.sisudoc.org/software/sisu";
+    #git clone git://git.sisudoc.org/software/sisu
+    sisu.inputs.nixpkgs.follows = "nixpkgs";
+    sisu.flake                = true;
+  };
+  outputs = { self, nixpkgs, flake-utils, sisu } @inputs:
+    let
+      version                  = "0.7.3";
+      shell                    = ./shell.nix; # ./default.nix;
+      devEnv                   = ./.envrc; # ./shell.nix; # ./default.nix;
+      supportedSystems         = [ "x86_64-linux" ]; # [ "x86_64-linux" "x86_64-darwin" "aarch64-linux" "aarch64-darwin" ];
+      forAllSystems            = nixpkgs.lib.genAttrs supportedSystems;
+      nixpkgsFor               = forAllSystems (system: import nixpkgs { inherit system;  }); # nixpkgs instantiated for supported system types.
+    in {
+      packages = forAllSystems (system:
+        let pkgs               = nixpkgsFor.${system};
+        in {
+          default              = sisu.packages.${system}.default;
+          #vendorSha256         = "sha256-0Q00000000000000000000000000000000000000000=";
+      });
+      devShells = forAllSystems (system:
+        let
+          pkgs = nixpkgsFor.${system};
+          shellHook = ''
+            export Date=`date "+%Y%m%d"`
+            ### set local values in .envrc-local (or modify here if you must)
+            # export sisuPROJ=~/grotto/repo/git.repo/projects/doc-reform/code/software/sisu
+            # export sisuDOC=~/grotto/repo/git.repo/projects/project-sisu/doc-reform-markup/sisu-markup-samples
+            # export sisu=/srv/www/sisu
+            # export sisu=/var/www/sqlite
+            # export sisu=/srv/www/sisu/sqlite
+            export sisu=$sisuPROJ/src
+            export sisu=$sisuPROJ/result/lib
+            export sisu=$sisuDOC/markup/pod
+            export sisu=$sisuOUT/$sisuVER
+            export sisu='http://localhost/sisu_search'
+            # export sisuSearchActionRemote='https://sisudoc.org/sisu_search'
+            export sisuCGIform='sisu_search'
+            export sisuSQLdb='sisusearch.db'
+            export PROG_VER_GIT="`git describe --long --tags | sed -e 's/^[ a-z_-]\+\([0-9.]\+\)/\1/;s/\([^-]*-g\)/r\1/;s/-/./g'`"
+            export PROG_VER_DECLARED="`cat ./views/version.txt | grep --color=never "enum" | sed 's/.\+(\([0-9]\+\),[ \t]\+\([0-9]\+\),[ \t]\+\([0-9]\+\)[ \t]*).\+/\1.\2.\3/g'`"
+            export sisuNixHelp="cat ./.env/nix-commands"
+            export sisuTest="nix shell .#default --print-build-logs --command sisu --very-verbose --epub --html --html-link-search --html-link-curate --curate --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuHtml="sisu --very-verbose --html --html-link-search --html-link-curate --curate --sqlite-update --sqlite-db-filename=\"sisu.search.db\" --cgi-sqlite-search-filename=\"sisu_search\" --sqlite-db-path=\"\$sisuDBpath\" --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuEpub="sisu --very-verbose --epub --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuLatex="sisu --very-verbose --latex --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuPdf="sisu --very-verbose --pdf --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuSqliteCreateDB="sisu --very-verbose --sqlite-db-recreate --sqlite-db-path=\"$sisuDBpath\" --sqlite-db-filename=\"sisu.search.db\""
+            export sisuSqlite="sisu --very-verbose --sqlite-discrete --sqlite-db-path=\"$sisuDBpath\" --sqlite-db-filename=\"sisu.search.db\" --output=\"\$sisuOUT\" $sisuPOD/*"
+            #export sisuSqlite="sisu --very-verbose --sqlite-update --sqlite-db-path=\"$sisuDBpath\" --sqlite-db-filename=\"sisu.search.db\" --output=\"\$sisuOUT\" $sisuPOD/*"
+          '';
+        in with pkgs; {
+          devShell = mkShell rec {
+            name               = "sisu dev shell default";
+            inherit shell;
+            inherit devEnv;
+            packages = [ sqlite ];
+            inherit shellHook;
+          };
+          devShell-epub = mkShell rec {
+            name               = "sisu dev shell for epub output";
+            inherit shell;
+            inherit devEnv;
+            packages = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              zip
+              unzip
+              xz
+              libxml2
+              html-tidy
+              xmlstarlet
+              epubcheck
+              ebook_tools
+              libxml2
+              html-tidy
+              xmlstarlet
+              epubcheck
+              ebook_tools
+              epr
+              sigil
+              calibre #(suite includes: ebook-viewer)
+              foliate
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+          devShell-html = mkShell rec {
+            name               = "sisu dev shell for latex & pdf output";
+            inherit shell;
+            inherit devEnv;
+            packages = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              zip
+              unzip
+              xz
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+          devShell-latex-pdf = mkShell rec {
+            name               = "sisu dev shell for latex & pdf output";
+            inherit shell;
+            inherit devEnv;
+            packages     = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              zip
+              unzip
+              xz
+              source-sans-pro
+              source-serif-pro
+              source-code-pro
+              texlive.combined.scheme-full
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+          devShell-sqlite = mkShell rec {
+            name               = "sisu dev shell for latex & pdf output";
+            inherit shell;
+            inherit devEnv;
+            packages = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              zip
+              unzip
+              xz
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+          devShell-i18n = mkShell {
+            name               = "sisu dev shell internationalization, po4a";
+            inherit shell;
+            inherit devEnv;
+            packages = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              perl534Packages.Po4a
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+      });
+  };
+}
diff --git a/org/config_git.org b/org/config_git.org
new file mode 100644
index 0000000..44668c1
--- /dev/null
+++ b/org/config_git.org
@@ -0,0 +1,89 @@
+-*- mode: org -*-
+#+TITLE:       configuration git
+#+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 - 2023 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/]]
+
+* spine
+** .gitignore :gitignore:
+
+#+HEADER: :tangle "../.gitignore"
+#+BEGIN_SRC sh
+# git ls-files --others --exclude-from=.git/info/exclude
+# git check-ignore -v flake.lock
+# git clean -ix
+# find . -name "*_" | xargs rm -rf
+,*
+!nix/**
+!*.nix
+!flake.lock
+!.envrc
+!.env
+!.env/**
+!README
+!COPYRIGHT
+!CHANGELOG
+!makefile
+!version.txt
+!configuration.txt
+!conf/
+!conf/**
+!*.json
+!tangle
+!*.org
+!org/
+!org/*.org
+!*.rb
+!*.sst
+!*.ssm
+!*.ssi
+!**/*.sst
+!**/*.ssm
+!**/*.ssi
+!data
+!data/**
+,*~
+,*_
+\#*
+,*.\#*
+,*.tmp
+,*_tmp
+,*.gem
+,*.gemspec
+,*_.rb
+,*.rb_
+0???-*.patch
+,*.gz
+,*.xz
+,*_
+.*
+!.gitignore
+!.gitattributes
+!.envrc
+!.env
+!.env/**
+#+END_SRC
+
+** .gitattributes :gitattributes:
+
+#+HEADER: :tangle-NO "../.gitattributes"
+#+BEGIN_SRC sh
+/org export-ignore
+.gitattributes export-ignore
+#.gitignore export-ignore
+tangle export-ignore
+flake.lock export-ignore
+#+END_SRC
diff --git a/org/config_nix.org b/org/config_nix.org
new file mode 100644
index 0000000..720d980
--- /dev/null
+++ b/org/config_nix.org
@@ -0,0 +1,1492 @@
+-*- mode: org -*-
+#+TITLE:       configuration nix
+#+DESCRIPTION: makefile for spine
+#+FILETAGS:    :spine:build:tools:
+#+AUTHOR:      Ralph Amissah
+#+EMAIL:       [[mailto:ralph.amissah@gmail.com][ralph.amissah@gmail.com]]
+#+COPYRIGHT:   Copyright (C) 2015 - 2023 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
+
+* nix :nix:
+
+#+NAME: nixpkgs_local
+#+BEGIN_SRC sh
+/srv/nix/nixpkgs
+#+END_SRC
+
+** spine
+
+- default.nix
+- shell.nix
+
+*** envrc :envrc:
+**** .envrc
+
+- https://github.com/nix-community/nix-direnv
+  - source_url "https://raw.githubusercontent.com/nix-community/nix-direnv/${NixDirEnvVersion}/direnvrc" "sha256-0000000000000000000000000000000000000000000="
+
+#+HEADER: :tangle ../.envrc
+#+BEGIN_SRC sh
+use flake .
+#use flake .#default
+NIX_ENFORCE_PURITY=1
+NixDirEnvVersion="2.2.1"
+if ! has nix_direnv_version || ! nix_direnv_version ${NixDirEnvVersion}; then
+# - https://github.com/nix-community/nix-direnv
+# source_url "https://raw.githubusercontent.com/nix-community/nix-direnv/${NixDirEnvVersion}/direnvrc" "sha256-0000000000000000000000000000000000000000000="
+  source_url "https://raw.githubusercontent.com/nix-community/nix-direnv/${NixDirEnvVersion}/direnvrc" "sha256-zelF0vLbEl5uaqrfIzbgNzJWGmLzCmYAkInj/LNxvKs="
+fi
+watch_file flake.lock
+watch_file flake.nix
+if [ -f .envrc-local ]; then
+  source_env_if_exists .envrc-local || source .envrc-local
+fi
+#nix flake update && nix flake check --show-trace && nix flake show
+#+END_SRC
+
+**** .envrc-local CHECK MODIFY
+
+- bespoke modify appropriately and generate if needed
+
+#+HEADER: :tangle ../.envrc-local_
+#+HEADER: :noweb yes
+#+BEGIN_SRC sh
+PATH_add result/bin
+export DFLAGS="-O2 -inline -boundscheck=on -color=on"
+#export sisuBIN=result/bin
+export sisuPROJ=~/grotto/repo/git.repo/projects/doc-reform/code/software/sisu
+export sisuDOC=.
+export sisuDBpath=/var/www/sqlite
+#export sisuDBpath=/srv/www/sisu/sqlite
+export sisuOUT=/srv/www/sisu
+export sisuCGIbin=/var/www/cgi/cgi-bin
+export sisuSearchActionLocal='http://localhost/sisu_search'
+export sisuSearchActionRemote='https://sisudoc.org/sisu_search'
+export sisuCGIform='sisu_search'
+export sisuSQLdb='spine.search.db'
+#+END_SRC
+
+*** flake :flake:
+**** flake
+***** flake.nix
+
+#+HEADER: :tangle ../flake.nix
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+{
+  description                  = "sisu parser & document generator";
+  inputs = {
+    nixpkgs.url                = "github:NixOS/nixpkgs/nixpkgs-unstable"; # "github:nixos/nixpkgs";
+    flake-utils.url            = "github:numtide/flake-utils";
+    sisu.url                  = "git://git.sisudoc.org/software/sisu";
+    #git clone git://git.sisudoc.org/software/sisu
+    sisu.inputs.nixpkgs.follows = "nixpkgs";
+    sisu.flake                = true;
+  };
+  outputs = { self, nixpkgs, flake-utils, sisu } @inputs:
+    let
+      version                  = "<<sisu_version_set>>";
+      shell                    = ./shell.nix; # ./default.nix;
+      devEnv                   = ./.envrc; # ./shell.nix; # ./default.nix;
+      supportedSystems         = [ "x86_64-linux" ]; # [ "x86_64-linux" "x86_64-darwin" "aarch64-linux" "aarch64-darwin" ];
+      forAllSystems            = nixpkgs.lib.genAttrs supportedSystems;
+      nixpkgsFor               = forAllSystems (system: import nixpkgs { inherit system;  }); # nixpkgs instantiated for supported system types.
+    in {
+      packages = forAllSystems (system:
+        let pkgs               = nixpkgsFor.${system};
+        in {
+          default              = sisu.packages.${system}.default;
+          #vendorSha256         = "sha256-0Q00000000000000000000000000000000000000000=";
+      });
+      devShells = forAllSystems (system:
+        let
+          pkgs = nixpkgsFor.${system};
+          shellHook = ''
+            export Date=`date "+%Y%m%d"`
+            ### set local values in .envrc-local (or modify here if you must)
+            # export sisuPROJ=~/grotto/repo/git.repo/projects/doc-reform/code/software/sisu
+            # export sisuDOC=~/grotto/repo/git.repo/projects/project-sisu/doc-reform-markup/sisu-markup-samples
+            # export sisu=/srv/www/sisu
+            # export sisu=/var/www/sqlite
+            # export sisu=/srv/www/sisu/sqlite
+            export sisu=$sisuPROJ/src
+            export sisu=$sisuPROJ/result/lib
+            export sisu=$sisuDOC/markup/pod
+            export sisu=$sisuOUT/$sisuVER
+            export sisu='http://localhost/sisu_search'
+            # export sisuSearchActionRemote='https://sisudoc.org/sisu_search'
+            export sisuCGIform='sisu_search'
+            export sisuSQLdb='sisusearch.db'
+            export PROG_VER_GIT="`git describe --long --tags | sed -e 's/^[ a-z_-]\+\([0-9.]\+\)/\1/;s/\([^-]*-g\)/r\1/;s/-/./g'`"
+            export PROG_VER_DECLARED="`cat ./views/version.txt | grep --color=never "enum" | sed 's/.\+(\([0-9]\+\),[ \t]\+\([0-9]\+\),[ \t]\+\([0-9]\+\)[ \t]*).\+/\1.\2.\3/g'`"
+            export sisuNixHelp="cat ./.env/nix-commands"
+            export sisuTest="nix shell .#default --print-build-logs --command sisu --very-verbose --epub --html --html-link-search --html-link-curate --curate --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuHtml="sisu --very-verbose --html --html-link-search --html-link-curate --curate --sqlite-update --sqlite-db-filename=\"sisu.search.db\" --cgi-sqlite-search-filename=\"sisu_search\" --sqlite-db-path=\"\$sisuDBpath\" --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuEpub="sisu --very-verbose --epub --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuLatex="sisu --very-verbose --latex --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuPdf="sisu --very-verbose --pdf --output=\"\$sisuOUT\" $sisuPOD/*"
+            export sisuSqliteCreateDB="sisu --very-verbose --sqlite-db-recreate --sqlite-db-path=\"$sisuDBpath\" --sqlite-db-filename=\"sisu.search.db\""
+            export sisuSqlite="sisu --very-verbose --sqlite-discrete --sqlite-db-path=\"$sisuDBpath\" --sqlite-db-filename=\"sisu.search.db\" --output=\"\$sisuOUT\" $sisuPOD/*"
+            #export sisuSqlite="sisu --very-verbose --sqlite-update --sqlite-db-path=\"$sisuDBpath\" --sqlite-db-filename=\"sisu.search.db\" --output=\"\$sisuOUT\" $sisuPOD/*"
+          '';
+        in with pkgs; {
+          devShell = mkShell rec {
+            name               = "sisu dev shell default";
+            inherit shell;
+            inherit devEnv;
+            packages = [ sqlite ];
+            inherit shellHook;
+          };
+          devShell-epub = mkShell rec {
+            name               = "sisu dev shell for epub output";
+            inherit shell;
+            inherit devEnv;
+            packages = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              zip
+              unzip
+              xz
+              libxml2
+              html-tidy
+              xmlstarlet
+              epubcheck
+              ebook_tools
+              libxml2
+              html-tidy
+              xmlstarlet
+              epubcheck
+              ebook_tools
+              epr
+              sigil
+              calibre #(suite includes: ebook-viewer)
+              foliate
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+          devShell-html = mkShell rec {
+            name               = "sisu dev shell for latex & pdf output";
+            inherit shell;
+            inherit devEnv;
+            packages = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              zip
+              unzip
+              xz
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+          devShell-latex-pdf = mkShell rec {
+            name               = "sisu dev shell for latex & pdf output";
+            inherit shell;
+            inherit devEnv;
+            packages     = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              zip
+              unzip
+              xz
+              source-sans-pro
+              source-serif-pro
+              source-code-pro
+              texlive.combined.scheme-full
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+          devShell-sqlite = mkShell rec {
+            name               = "sisu dev shell for latex & pdf output";
+            inherit shell;
+            inherit devEnv;
+            packages = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              zip
+              unzip
+              xz
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+          devShell-i18n = mkShell {
+            name               = "sisu dev shell internationalization, po4a";
+            inherit shell;
+            inherit devEnv;
+            packages = [
+              ruby_3_1
+              rubyPackages_3_1.rake
+              rubyPackages_3_1.sqlite3
+              rubyPackages_3_1.thor
+              sqlite
+              perl534Packages.Po4a
+              devenv
+              nixFlakes
+              validatePkgConfig
+              jq
+              git
+            ];
+            inherit shellHook;
+          };
+      });
+  };
+}
+#+END_SRC
+
+*** flake :flake:
+**** notes?
+
+- flake.nix
+    /srv/nix/nixpkgs
+    ./shell.nix
+  - shell.nix
+      ./pkgs/shell-pkgs.nix
+    - pkgs/shell-pkgs.nix
+  - default.nix
+     ./nix/dub.selections.nix #
+    - dub.selections.nix
+
+- nix develop
+
+- nix flake update
+
+- nix shell -f default.nix --print-build-logs
+- nix shell -c default.nix
+
+- nix build `nix-instantiate`
+- nix build -f default.nix --print-build-logs
+- nix shell -f default.nix --print-build-logs
+- nix develop --build -f derivation.nix -I .envrc --print-build-logs
+- nix develop --profile .#default --print-build-logs --command spine -v
+
+- nix search --json 2>/dev/null |jq
+- nix flake show
+- nix show-derivation
+
+# nix-instantiate | nix-build
+
+#nix flake update
+#nix flake check
+#nix flake show
+#nix develop
+#nix build .#default --print-build-logs
+
+#+BEGIN_SRC nix
+src = fetchTarball {
+  url       = "file:///[path]/$(pname)-$(version).tar.gz";
+  sha256    = "sha256:0000000000000000000000000000000000000000000000000000";
+};
+#+END_SRC
+
+**** flake parts
+***** flake metadata
+
+#+NAME: flake_metadata
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+pname       = "spine";
+version     = "<<sisu_version_set>>";
+description = "a sisu like parser and document generator";
+#+END_SRC
+
+***** flake inputs
+****** flake inputs static
+
+#+NAME: flake_inputs_nix
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+nixpkgs.url          = "github:nixos/nixpkgs";
+flake-utils.url      = "github:numtide/flake-utils";
+#+END_SRC
+
+****** flake inputs for dub2nix
+
+#+NAME: flake_inputs_dub2nix
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+flake-utils.url    = "github:numtide/flake-utils";
+nixpkgs.url        = "github:nixos/nixpkgs";
+d2sqlite3-src      = { url = "github:dlang-community/d2sqlite3"; flake = false; };
+tinyendian-src     = { url = "github:kiith-sa/tinyendian";       flake = false; };
+dyaml-src          = { url = "github:dlang-community/D-YAML";    flake = false; };
+imageformats-src   = { url = "github:lgvz/imageformats";         flake = false; };
+dub2nix-src        = { url = "github:lionello/dub2nix";          flake = false; };
+#+END_SRC
+
+***** flake outputs
+****** flake outputs static
+
+#+NAME: flake_outputs
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+self, nixpkgs, flake-utils
+#+END_SRC
+
+****** flake outputs for dub2nix
+
+#+NAME: flake_outputs_dub2nix
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+self, nixpkgs, flake-utils, dub2nix-src, d2sqlite3-src, tinyendian-src, dyaml-src, imageformats-src
+#+END_SRC
+
+***** flake devshells
+
+#+NAME: flake_devshells
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+devShells               = forAllSystems (system:
+  let pkgs              = nixpkgsFor.${system};
+  in {
+    default = pkgs.mkShell {
+      buildInputs       = with pkgs; [ git dub dmd ldc sqlite ];
+    };
+});
+#+END_SRC
+
+***** flake phases
+
+#+NAME: flake_phases
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+buildPhase = ''
+  runHook preBuild
+  HOME="$PWD"
+  for DC_ in dmd ldmd2 ldc2 gdc gdmd; do
+    echo "- check for D compiler $DC_"
+    DC=$(type -P $DC_ || echo "")
+    if [ ! "$DC" == "" ]; then break; fi
+  done
+  if [ "$DC" == "" ]; then exit "Error: could not find D compiler"; fi
+  echo "$DC_ used as D compiler to build $pname"
+  dub build --compiler=$DC --build=$DC_ --combined --skip-registry=all
+  runHook postBuild
+'';
+<<flake_phases_other_than_buildPhase>>
+#+END_SRC
+
+#+NAME: flake_phases_other_than_buildPhase
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+checkPhase = ''
+  runHook preCheck
+  dub test --combined --skip-registry=all
+  runHook postCheck
+'';
+installPhase = ''
+  runHook preInstall
+  mkdir -p $out/bin
+  install -m755 ./bin/spine $out/bin/spine
+  runHook postInstall
+'';
+postInstall = ''
+  echo `ls -la $out/bin/spine`
+  echo "
+  nix build or nix develop? (suggestions):
+  - nix build
+    nix build .#default --print-build-logs
+    nix flake update; nix build .#default --print-build-logs
+      nix build --print-build-logs
+  - nix run
+    nix run .#default --print-build-logs
+    nix run default.nix --print-build-logs
+  - nix shell
+    nix shell .#default --print-build-logs --command spine -v
+  - nix develop
+    nix develop --profile .#default --print-build-logs --command spine -v
+    nix develop ; eval \"$buildPhase\"
+    nix develop --build -f derivation.nix -I .envrc --print-build-logs
+  - nix profile install . --print-build-logs
+  spine -v
+  nix-instantiate | nix show-derivation | jq
+  "
+  $out/bin/spine -v
+'';
+#+END_SRC
+
+***** d-compiler (dmd ldc gdc)
+
+- dmd ldc gdc
+
+#+NAME: d-compiler
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+dmd
+#+END_SRC
+
+***** flake spine dub2nix
+
+#+NAME: flake_output_spine_dub2nix
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+packages.x86_64-linux.spine =
+  let
+    pkgs            = import nixpkgs {
+      system        = "x86_64-linux";
+    };
+    #targetOf = package: "${package.targetPath or "."}/${package.targetName or package.name}";
+  in
+    pkgs.stdenv.mkDerivation {
+      pname         = "spine";
+      version       = "<<sisu_version_set>>";
+      description   = "a sisu like parser and document generator";
+      inherit self;
+      src           = self;
+      shell         = ./shell.nix;
+      <<flake_phases>>
+      buildInputs       = [ sqlite ];
+      nativeBuildInputs = with pkgs; [ dub ldc ];
+    };
+#+END_SRC
+
+***** flake misc
+
+#+BEGIN_SRC nix
+src = fetchTarball {
+  url       = "file:///[path]/$(pname)-$(version).tar.gz";
+  sha256    = "sha256:0000000000000000000000000000000000000000000000000000";
+};
+#+END_SRC
+
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+{
+  description = "a sisu like parser & document generator";
+  inputs = {
+    flake-utils.url = "github:numtide/flake-utils";
+    nixpkgs.url = "<<nixpkgs_url>>";
+  };
+  outputs = { self, nixpkgs, flake-utils }:
+  let
+    pkgs = nixpkgs.legacyPackages.x86_64-linux;
+  in {
+    packages.x86_64-linux.spine = pkgs.stdenv.mkDerivation {
+      name = "spine";
+      inherit self;
+      src = self;
+      shell = ./shell.nix;
+      installPhase = ''
+         install -m755 spine $out/bin/spine
+      '';
+    };
+    defaultPackage.x86_64-linux = self.packages.x86_64-linux.spine;
+  };
+}
+#+END_SRC
+
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+{
+  description = "a sisu like document parser";
+  inputs = {
+    flake-utils.url = "github:numtide/flake-utils";
+    nixpkgs.url = "<<nixpkgs_url>>";
+    d2sqlite3 = {
+      url    = "github:dlang-community/d2sqlite3";
+      flake  = false;
+    };
+    tinyendian = {
+      url    = "github:kiith-sa/tinyendian";
+      flake  = false;
+    };
+    dyaml = {
+      url    = "github:dlang-community/D-YAML";
+      flake  = false;
+    };
+    imageformats = {
+      url    = "github:lgvz/imageformats";
+      flake  = false;
+    };
+  };
+  outputs = { self, d2sqlite3, tinyendian, dyaml, imageformats, nixpkgs, flake-utils }:
+  let
+    pkgs = nixpkgs.legacyPackages.x86_64-linux;
+  in {
+    packages.x86_64-linux.spine = pkgs.stdenv.mkDerivation {
+      name = "spine";
+      inherit self;
+      src = self;
+      shell = ./shell.nix;
+      installPhase = ''
+         install -m755 spine $out/bin/spine
+      '';
+    };
+    defaultPackage.x86_64-linux = self.packages.x86_64-linux.spine;
+  };
+}
+#+END_SRC
+
+*** shell.nix :shell:
+**** tangle
+
+#+HEADER: :tangle ../shell.nix
+#+HEADER: :tangle-mode (identity #o755)
+#+HEADER: :shebang "#!/usr/bin/env -S nix-shell --pure\n#!nix-shell -i bash"
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+{ pkgs ? import <nixpkgs> {} }:
+let
+in pkgs.mkShell {
+  buildInputs = with pkgs; [
+    nix
+    bundler
+    bundix
+    #ruby
+    #rubyPackages.rake
+    #rubyPackages.sqlite3
+    #rubyPackages.thor
+    ruby_3_1
+    rubyPackages_3_1.rake
+    rubyPackages_3_1.sqlite3
+    rubyPackages_3_1.thor
+    sqlite
+    unzip
+    xz
+    zip
+    #texlive-combined-full
+  ];
+}
+#+END_SRC
+
+**** Notes
+
+#+BEGIN_SRC text
+#% Notes
+
+# - shell.nix -I .envrc
+# - shell.nix -I .envrc --pure
+
+# [ nix-shell ]
+
+  # - nix-shell -I nixpkgs=/srv/nix/nixpkgs --pure
+  # - nix-shell -p "with import /srv/nix/nixpkgs {}; ldc" --pure
+  # - nix-shell -p "with import /srv/nix/nixpkgs {}; [dub ldc]" --pure
+
+  # - nix-shell -p nixVersions.unstable #nixFlakes
+  # - nix-shell -p nixFlakes --pure
+  # - nix-shell -p nixFlakes --pure -p "with import /srv/nix/nixpkgs {}; [nix dub ldc git ps]"
+  # - nix-shell shell.nix direnv: export +IN_NIX_SHELL
+  # - nix-shell shell.nix
+
+# [ nix-build ]
+
+  # - nix-build -I nixpkgs=/srv/nix/nixpkgs # --pure
+  # - nix-build -I .envrc --pure
+  # - nix-build default.nix -I .envrc && result/bin/spine -v
+
+# [ nix-instantiate ]
+
+  # - nix-instantiate | nix show-derivation | jq
+  # - nix-instantiate -I .envrc | nix show-derivation -f derivation.nix -I .envrc | jq
+  # - nix-instantiate | nix show-derivation --recursive | jq
+  # - nix-instantiate -I .envrc | nix show-derivation -f derivation.nix --recursive -I .envrc | jq
+  # - nix-instantiate | nix-build
+  # - nix-instantiate -I .envrc | nix-build -I .envrc
+
+# [ nix shell ]
+
+  # - nix shell -c default.nix
+  # - nix shell -f default.nix --print-build-logs
+
+# [ nix build ]
+
+  # - nix build -I .envrc --print-build-logs
+  # - nix build -f default.nix --print-build-logs
+  # - nix build -f derivation.nix --print-build-logs
+
+  # - nix build `nix-instantiate`
+  # - nix build `nix-instantiate -I .envrc`
+
+  # - nix build -f default.nix && ./result/bin/spine -v && noti -t "spine build" -m "see ./result/bin/spine"
+  # - nix build .#default
+
+# [ nix run ]
+
+  # - nix run default.nix --print-build-logs
+  # - nix run -I .envrc default.nix --print-build-logs
+  # - nix run .#default
+
+# - nix-shell -I .envrc --pure
+# - nix develop --build -f derivation.nix -I .envrc --print-build-logs
+
+# - nix-shell -p nixFlakes --pure -p "with import /srv/nix/nixpkgs {}; [nix dub ldc git ps]"
+# - nix-build
+# - nix build `nix-instantiate -I .envrc`
+
+# - nix develop --build -f default.nix -I .envrc
+
+# - nix-shell -I .envrc --pure
+# - nix-build default.nix -I .envrc && result/bin/spine -v
+
+# - nix shell -f default.nix --print-build-logs
+# - nix-instantiate -I .envrc | nix-build -I .envrc
+#+END_SRC
+
+#+BEGIN_SRC text
+#% Notes
+- nix-shell
+
+- shell.nix --pure
+- shell.nix --pure -I .envrc
+
+- nix-shell --pure -I nixpkgs=<<nixpkgs_local>>
+- nix-shell --pure -p "with import <<nixpkgs_local>> {}; ldc"
+- nix-shell --pure -p "with import /srv/nix/nixpkgs {}; [dub ldc]"
+
+- shell.nix direnv: export +IN_NIX_SHELL
+
+- nix-shell -p nixFlakes
+- nix-shell -p nixFlakes --pure
+- nix-shell -p nixFlakes --pure -p "with import /srv/nix/nixpkgs {}; [dub ldc]"
+
+- shell.nix -I .envrc
+- nix-shell -I nixpkgs=<provide local nix path>
+- nix-shell -I nixpkgs=<provide local nix path> --pure
+- shell.nix
+- nix-shell shell.nix --pure
+
+- nix shell -c default.nix
+
+- nix run default.nix --print-build-logs
+- nix run -I .envrc default.nix --print-build-logs
+
+- nix develop
+
+- nix-build -I nixpkgs=<provide local nix path>
+- nix-build -I .envrc
+
+- nix build -f default.nix --print-build-logs
+- nix build -f derivation.nix --print-build-logs
+- nix build -I .envrc --print-build-logs
+- nix shell -f default.nix --print-build-logs
+- nix develop --build -f derivation.nix -I .envrc --print-build-logs
+
+- buildPhase
+
+- nix build -f default.nix && noti
+- nix build -f default.nix && ./result/bin/spine -v && noti -t "spine build" -m "see ./result/bin/spine"
+- nix develop --build -f derivation.nix -I .envrc --print-build-logs
+
+  ./result/bin/spine
+#+END_SRC
+
+**** shell parts (packages)
+***** packages nix related
+
+#+NAME: shell_packages_nix_related
+#+BEGIN_SRC nix
+### nix_related
+direnv
+nixVersions.unstable #nixFlakes
+nix-prefetch-git
+validatePkgConfig
+jq
+git
+ps
+#+END_SRC
+
+***** packages d build related
+
+#+NAME: shell_packages_d_build_related
+#+BEGIN_SRC nix
+### d_build_related
+## package manager
+dub
+## compiler
+ldc
+rund
+## linker
+#lld
+#mold
+## builder
+#ninja
+#meson
+#+END_SRC
+
+***** packages tools
+
+#+NAME: shell_packages_tool_download
+#+BEGIN_SRC nix
+### tools
+#curl
+#wget
+aria
+#+END_SRC
+
+***** packages candy
+
+#+NAME: shell_packages_candy
+#+BEGIN_SRC nix
+### candy
+starship
+#+END_SRC
+
+***** packages search sqlite related
+
+#+NAME: shell_packages_search_related_sqlite
+#+BEGIN_SRC nix
+### sqlite search related
+sqlite
+#+END_SRC
+
+***** packages pdf latex related
+
+#+NAME: shell_packages_pdf_latex_related
+#+BEGIN_SRC nix
+### pdf_latex_related
+source-sans-pro
+source-serif-pro
+source-code-pro
+texlive.combined.scheme-full
+#+END_SRC
+
+***** packages xml epub related
+
+#+NAME: shell_packages_xml_and_epub_related
+#+BEGIN_SRC nix
+### xml_and_epub_related
+libxml2
+html-tidy
+xmlstarlet
+epubcheck
+ebook_tools
+epr
+sigil
+calibre #(suite includes: ebook-viewer)
+foliate
+#+END_SRC
+
+***** packages i18n_translation related
+
+#+NAME: shell_packages_i18n_translation
+#+BEGIN_SRC nix
+### i18n translation related
+perl534Packages.Po4a
+#+END_SRC
+
+*** default.nix :default:
+
+- default.nix -I nixpkgs=<provide local nix path>
+  e.g. default.nix -I nixpkgs=/srv/nix/nixpkgs
+
+- nix-build -I nixpkgs=<provide local nix path>
+  e.g. nix-build -I nixpkgs=<<nixpkgs_local>>
+
+#+HEADER: :noweb yes
+#+BEGIN_SRC sh
+nix-build -I nixpkgs=<<nixpkgs_local>>
+nix-build -I .envrc-local
+nix-build -I .envrc
+default.nix -I .envrc
+default.nix
+
+nix build -f default.nix --print-build-logs
+nix build -f derivation.nix --print-build-logs
+nix shell -f default.nix --print-build-logs
+nix develop --build -f derivation.nix -I .envrc --print-build-logs
+
+# nix build -f project.nix
+# nix build -f spine.nix
+#+END_SRC
+
+
+*** project meta
+
+#+NAME: nix_project_meta
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+meta = with pkgs.lib; {
+  pname       = "spine";
+  version     = "<<sisu_version_set>>";
+  description = "a sisu like document parser";
+  longDescription = ''
+    A sisu like parser and document generator
+  '';
+  homepage    = "https://sisudoc.org";
+  license     = licenses.agpl3Plus;
+  platforms   = platforms.linux;
+  maintainers = [ "RalphAmissah" ];
+};
+#+END_SRC
+
+*** dub.selections.json
+
+#+HEADER: :NO-tangle ../dub.selections.json
+#+BEGIN_SRC nix
+{
+	"fileVersion": 1,
+	"versions": {
+		"d2sqlite3": "0.19.1",
+		"dyaml": "0.8.3",
+		"imageformats": "7.0.2",
+		"tinyendian": "0.2.0"
+	}
+}
+#+END_SRC
+
+*** dub.selections.nix
+
+#+HEADER: :NO-tangle ../nix/dub.selections.nix
+#+BEGIN_SRC nix
+# This file was generated by https://github.com/lionello/dub2nix v0.2.3
+[ {
+  fetch = {
+    type = "git";
+    url = "https://github.com/dlang-community/d2sqlite3.git";
+    rev = "v0.19.1";
+    sha256 = "0rnsgla6xyr8r34knf7v6dwhacra96q1b5rhxcz9246inwhvrk5k";
+    fetchSubmodules = false;
+    date = "2020-07-21T12:32:51+02:00";
+    deepClone = false;
+    leaveDotGit = false;
+    path = "/nix/store/hsi8xvl15w6fwlqvs042m1z5i88yc72i-d2sqlite3";
+  };
+} {
+  fetch = {
+    type = "git";
+    url = "https://github.com/kiith-sa/tinyendian.git";
+    rev = "v0.2.0";
+    sha256 = "086gf5aga52wr5rj2paq54daj8lafn980x77b706vvvqaz2mlis8";
+    fetchSubmodules = false;
+    date = "2018-06-10T11:04:28+02:00";
+    deepClone = false;
+    leaveDotGit = false;
+    path = "/nix/store/9c7fsmi5am84j6dq2mp3va306x3ay291-tinyendian";
+  };
+} {
+  fetch = {
+    type = "git";
+    url = "https://github.com/kiith-sa/D-YAML.git";
+    rev = "v0.8.3";
+    sha256 = "13wy304xjbwkpgg7ilql1lkxkm83s87jm59ffnrg26slp7cx149q";
+    fetchSubmodules = false;
+    date = "2020-09-19T23:46:57+02:00";
+    deepClone = false;
+    leaveDotGit = false;
+    path = "/nix/store/3i8i56lkmw2xq3lxr5h66v909waq2mqg-D-YAML";
+  };
+} {
+  fetch = {
+    type = "git";
+    url = "https://github.com/lgvz/imageformats.git";
+    rev = "v7.0.2";
+    sha256 = "1mfbsmi4fs1xny4zqs6jyr04d5f4h03r9f6jadvkdqj5kd1k0ws7";
+    fetchSubmodules = false;
+    date = "2019-10-10T07:54:45+03:00";
+    deepClone = false;
+    leaveDotGit = false;
+    path = "/nix/store/wn554pn21nzmpvw2hs7hvv9v9y0sgarg-imageformats";
+  };
+} ]
+#+END_SRC
+
+*** dub2nix & shared pkgs SHARED
+**** dub2nix with pkgs shared
+
+#+NAME: nix_with_pkgs
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+with pkgs; [
+  <<nix_shell_with_pkgs_list>>
+]
+#+END_SRC
+
+**** with pkgs list
+
+#+NAME: nix_shell_with_pkgs_list
+#+BEGIN_SRC nix
+nixVersions.unstable #nixFlakes
+rund
+dub
+ldc
+sqlite
+nix-prefetch-git
+validatePkgConfig
+jq
+git
+#+END_SRC
+
+** variables
+*** spine version SET VERSION :version:set:project:
+
+#+NAME: sisu_version_set
+#+BEGIN_SRC sh
+0.7.3
+#+END_SRC
+
+*** set names SET
+
+#+NAME: spine_search_db
+#+BEGIN_SRC sh
+spine.search.db
+#+END_SRC
+
+#+NAME: spine_search_cgi
+#+BEGIN_SRC sh
+spine_search
+#+END_SRC
+
+*** nixpkgs_path SETUP
+**** nixpkgs select path SELECT
+
+#+NAME: nixpkgs_path
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+<<nixpkgs_path_local>>
+#+END_SRC
+
+**** nixpkgs path options
+
+- <nixpkgs>
+
+#+NAME: nixpkgs_path_default
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+<nixpkgs>
+#+END_SRC
+
+#+NAME: nix_path_directory
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+nixpkgs=<<nixpkgs_path_local>>
+#+END_SRC
+
+#+NAME: project_path_local_project
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+~/grotto/repo/git.repo/projects/project-spine/doc-reform
+#+END_SRC
+
+#+NAME: project_path_local_src
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+<<project_path_local_project>>/src
+#+END_SRC
+
+#+NAME: project_path_local_bin
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+<<project_path_local_project>>/result/bin
+#+END_SRC
+
+#+NAME: project_path_cgi_bin
+#+BEGIN_SRC nix
+/var/www/cgi/cgi-bin
+#+END_SRC
+
+#+NAME: project_path_local_doc
+#+BEGIN_SRC nix
+~/grotto/repo/git.repo/projects/project-spine/doc-reform-markup/spine-markup-samples
+#+END_SRC
+
+#+NAME: project_path_local_out
+#+BEGIN_SRC nix
+/srv/www/spine/$SpineVER
+#+END_SRC
+
+#+NAME: project_path_local_out_
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+/tmp/spine/$SpineVER/www
+#+END_SRC
+
+#+NAME: project_path_local_out_static
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+/srv/www/spine
+#+END_SRC
+
+#+NAME: project_path_local_out_static_
+#+BEGIN_SRC nix
+/var/www
+#+END_SRC
+
+#+NAME: project_path_sqlite
+#+BEGIN_SRC nix
+/var/www/sqlite
+#+END_SRC
+
+#+NAME: nixpkgs_url
+#+BEGIN_SRC nix
+github:nixos/nixpkgs
+#+END_SRC
+
+#+HEADER: :noweb yes
+#+BEGIN_SRC nix
+<<nixpkgs_path_local>>
+#+END_SRC
+
+- local path SET WARN
+
+#+NAME: nixpkgs_path_local
+#+BEGIN_SRC nix
+/srv/nix/nixpkgs
+#+END_SRC
+
+**** project path options
+
+- local path SET WARN
+
+#+NAME: nix_path_channel
+#+BEGIN_SRC nix
+/nix/var/nix/profiles/per-user/root/channels/nixos
+#+END_SRC
+
+** texlive xetex xelatex shell.nix
+*** shell.nix :shell:
+
+#+BEGIN_SRC nix
+#!/usr/bin/env -S nix-shell --pure
+{ pkgs ? import <nixpkgs> {} }:
+pkgs.mkShell {
+  buildInputs = with pkgs; [
+    nixVersions.unstable #nixFlakes
+    nix-prefetch-git
+    validatePkgConfig
+    jq
+    git
+    fontconfig
+    source-sans-pro
+    source-serif-pro
+    source-code-pro
+    #(texlive.combine {
+    #  inherit (texlive) scheme-tetex xetex fontspec footmisc multirow titlesec listings anysize float graphics helvetic times courier;
+    #})
+    texlive.combined.scheme-full
+    dejavu_fonts dejavu_fontsEnv
+    liberation_ttf
+    evince
+    zathura
+    apvlv
+  ];
+    #FONTCONFIG_FILE = makeFontsConf { fontDirectories = [
+    #  liberation_ttf
+    #];
+  shellHook = ''
+    if [[ -f ".envrc" ]]; then
+      source .envrc
+    fi
+    #for texfile in *.tex; do xelatex -interaction=nonstopmode $texfile; done
+    #for texfile in *.tex; do xelatex -interaction=batchmode $texfile; done
+  '';
+}
+#+END_SRC
+
+*** notes
+
+#+BEGIN_SRC sh
+nix-shell --run 'which xetex'
+echo 'for texfile in *.tex; do echo "* --> " ~ $texfile && xelatex -interaction=batchmode $texfile; rm *.aux *.log *.toc *.out; done'
+
+$SpineBIN/spine --latex --serial --output="$SpineOUT" $SpinePOD/* && for texfile in $SpineOUT/latex/*.tex; do xelatex -interaction=nonstopmode $texfile; done 2>&1 | tee _err.xelatex_.org; ls $SpineOUT/latex/*.{tex,pdf}
+
+/run/current-system/sw/share/X11/fonts/
+
+kpsewhich pdftexconfig.tex
+/nix/store/2r4qa8rbll085nmpx56jg1rbmbir1zkp-texlive-combined-2021/share/texmf/tex/generic/tex-ini-files/pdftexconfig.tex
+/nix/store/2r4qa8rbll085nmpx56jg1rbmbir1zkp-texlive-combined-2021/share/texmf/fonts/opentype/public/
+
+find: texclive-fonts.conf
+fc-cache && mkfontscale && mkfontdir
+
+fc-match LiberationSans
+
+cd /nix/var/nix/profiles/system/sw/share/X11/fonts
+fc-query LiberationSans-Regular.ttf | grep '^\s\+family:' | cut -d'"' -f2
+Liberation Sans
+fc-query LiberationMono-Regular.ttf | grep '^\s\+family:' | cut -d'"' -f2
+Liberation Mono
+
+fc-query DejaVuSans.ttf | grep '^\s\+family:' | cut -d'"' -f2
+
+$XDG_DATA_HOME/fonts
+~/.local/share/fonts
+#+END_SRC
+
+** NOTES
+*** nix-shell
+
+- default.nix
+
+#+BEGIN_SRC sh
+nix-shell
+nix-build
+#+END_SRC
+
+- project.nix
+
+#+BEGIN_SRC sh
+nix-shell
+nix-build project.nix
+#+END_SRC
+
+*** nix-shell --pure
+
+- default.nix
+
+#+HEADER: :noweb yes
+#+BEGIN_SRC sh
+nix-shell --pure
+nix-build -I nixpkgs=<<nixpkgs_local>>
+nix-build -I .envrc
+#+END_SRC
+
+#+BEGIN_SRC sh
+nix build -f default.nix --print-build-logs
+nix build -f derivation.nix --print-build-logs
+nix shell -f default.nix --print-build-logs
+# nix build -f project.nix
+# nix build -f spine.nix
+nix develop --build -f derivation.nix -I .envrc --print-build-logs
+nix develop --profile .#default --print-build-logs --command spine -v
+#+END_SRC
+
+*** derivation .drv
+
+#+BEGIN_SRC sh
+nix show-derivation /nix/store/q7n14bm8j5vzm62qaraczdb4bpyf59vv-spine-0.11.1.drv
+#+END_SRC
+
+**** .env/echo-nixNote CHECK MODIFY
+
+#+HEADER: :tangle ../.env/nix-commands
+#+BEGIN_SRC text
+- nix flake update && nix flake check --show-trace && nix flake show && nix develop .#devShell
+
+- nix build .#default --print-build-logs
+- nix build .#spine-dmd --print-build-logs
+- nix build .#spine-ldc --print-build-logs
+- nix build .#spine-gdc --print-build-logs
+
+- nix develop
+  - nix develop .#devShell --print-build-logs
+  - nix develop .#devShell-html --print-build-logs
+  - nix develop .#devShell-epub --print-build-logs
+  - nix develop .#devShell-latex-pdf --print-build-logs
+  - nix develop .#devShell-sqlite --print-build-logs
+  - nix develop .#devShell-i18n --print-build-logs
+
+nix run .#default --print-build-logs
+
+nix develop --build .#default --print-build-logs
+
+nix-shell '<nixpkgs>' -A nix --pure
+#+END_SRC
+
+#+HEADER: :tangle ../.env/echo-nixNote
+#+BEGIN_SRC sh
+echo '-*- mode: org -*-
+
+,* nixpkgs path?
+
+  # eval "$(nix print-dev-env)"
+' > nixNote_.org
+
+echo "  <nixpkgs> == `nix-instantiate --find-file nixpkgs`" >> nixNote_.org
+
+echo '
+,* nix build and show derivation
+
+,#+BEGIN_SRC sh
+nix-shell --pure
+
+nix-build
+nix build -f default.nix --print-build-logs
+nix shell -f default.nix --print-build-logs
+nix develop --build -f derivation.nix -I .envrc --print-build-logs
+
+nix-instantiate | nix-build
+
+nix-instantiate -I .envrc | nix-build -I .envrc
+nix build `nix-instantiate`
+nix build `nix-instantiate -I .envrc`
+
+nix develop
+
+nix-instantiate | nix show-derivation | jq
+nix-instantiate -I .envrc | nix show-derivation -f derivation.nix -I .envrc | jq
+
+nix-instantiate | nix show-derivation --recursive | jq
+nix-instantiate -I .envrc | nix show-derivation -f derivation.nix --recursive -I .envrc | jq
+
+nix search --json 2>/dev/null |jq
+,#+END_SRC
+
+,* version and build info
+
+,#+BEGIN_SRC sh' >> nixNote_.org
+
+echo 'spine version (git) == $SpineVER' >> nixNote_.org
+echo "spine version (git) == $SpineVER" >> nixNote_.org
+echo 'nix-instantiate == `nix-instantiate`' >> nixNote_.org
+echo "nix-instantiate == `nix-instantiate`" >> nixNote_.org
+
+echo "#+END_SRC
+
+,* initialised shell variables
+
+,#+BEGIN_SRC sh
+SpineSRC=$SpineSRC
+SpineDOC=$SpineDOC
+SpinePOD=$SpinePOD
+SpineOUTversioned=$SpineOUTversioned
+SpineOUT=$SpineOUT
+,#+END_SRC
+" >> nixNote_.org
+
+echo '* spine run instruction examples
+,** parallelized tasks
+,*** doc source
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --pod --source --output="$SpineOUTversioned" $SpinePOD/*
+,#+END_SRC
+
+,*** html & epub output
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --html --epub --output="$SpineOUTversioned" $SpinePOD/*
+,#+END_SRC
+
+,*** sqlite db for each document - populate each db
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-discrete --output="$SpineOUTversioned" $SpinePOD/*
+,#+END_SRC
+
+,*** doc source; html, epub; sqlite outputs
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --verbose --pod --html --epub --sqlite-discrete --output="$SpineOUTversioned" $SpinePOD/*
+,#+END_SRC
+
+,*** curate (authors topics)
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --curate --output="$SpineOUTversioned" $SpinePOD/*
+,#+END_SRC
+
+,*** html, curate
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --verbose --dark --html --html-link-curate --curate --output="$SpineOUTversioned" $SpinePOD/*
+$SpineBIN/spine --very-verbose --html --html-link-curate --curate --output="$SpineOUTversioned" $SpinePOD/*
+,#+END_SRC
+
+,*** composite command: source pod, html, epub, curate, sqlite
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --verbose --dark --pod --epub --html --html-link-curate --curate --sqlite-discrete --output="$SpineOUTversioned" $SpinePOD/*
+,#+END_SRC
+
+,** sequential tasks
+,*** sqlite db (shared) - create db
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-db-create --output="$SpineOUTversioned"
+,#+END_SRC
+
+,*** sqlite db (shared) - populate db
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-update --output="$SpineOUTversioned" $SpineDOC/spine-markup-samples/markup/pod/*
+,#+END_SRC
+
+,*** sqlite db (shared) - drop db
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-db-drop --output="$SpineOUTversioned"
+,#+END_SRC
+
+,*** sqlite db (shared) - create & populate db (single step)
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-db-create --sqlite-update --output="$SpineOUTversioned" $SpinePOD/*
+,#+END_SRC
+
+,*** composite command: source pod, html, epub, curate, sqlite
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --verbose --no-parallel --dark --pod --epub --html --html-link-curate --curate --sqlite-discrete --output="$SpineOUTversioned" $SpinePOD/*
+,#+END_SRC
+
+,** config [./pod/].dr/config_local_site
+
+,#+BEGIN_SRC sh
+cat $SpinePOD/.dr/config_local_site
+$SpineBIN/spine --show-config $SpinePOD
+$SpineBIN/spine --show-config --output="$SpineOUTversioned" $SpinePOD
+,#+END_SRC
+
+,** cgi operations (output to $SpineOUT /var/www)
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --very-verbose --sqlite-db-create --output="$SpineOUT" $SpinePOD/*
+
+$SpineBIN/spine -v --cgi-search-form-codegen --output=$SpineOUT $SpinePOD/*
+
+$SpineBIN/spine -v --show-config --config=$SpinePOD/.dr
+
+$SpineBIN/spine --html $SpinePOD/*
+
+
+$SpineBIN/spine -v --cgi-search-form-codegen --config=$SpinePOD/.dr/config_local_site
+,#+END_SRC
+
+,*** generate html linked to search form
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine -v --html --html-link-search --html-link-curate --curate  --output=$SpineOUT $SpinePOD/*
+,#+END_SRC
+
+,*** create or re-create sql db (--sqlite-db-create or --sqlite-db-recreate)
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine -v --sqlite-db-create --sqlite-db-filename="<<spine_search_db>>" --sqlite-db-path="$SpineDBpath"
+$SpineBIN/spine -v --sqlite-db-recreate --sqlite-db-filename="<<spine_search_db>>" --sqlite-db-path="$SpineDBpath"
+,#+END_SRC
+
+,*** populate sqlite db
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine -v --sqlite-update --sqlite-db-filename="<<spine_search_db>>" --output=$SpineOUT $SpinePOD/*
+,#+END_SRC
+
+,*** generate html (linked to search form), sql output, curate COMPOSITE
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine -v --html --html-link-search --html-link-curate --curate --sqlite-update --sqlite-db-filename="<<spine_search_db>>" --cgi-sqlite-search-filename="<<spine_search_cgi>>" --sqlite-db-path="$SpineDBpath" --output="$SpineOUT" $SpinePOD/*
+$SpineBIN/spine --epub --html --html-link-search --html-link-curate --curate --sqlite-update --sqlite-db-filename="spine.search.db" --cgi-sqlite-search-filename="spine_search" --cgi-url-action="https://sisudoc.org/spine_search" --ouput="$SpineOUT" $SpinePOD/*
+,#+END_SRC
+
+,*** generate html (linked to search form), sql output, curate COMPOSITE with resource configuration
+
+if names and paths are configured in resource configuration file, e.g. $SpinePOD/.rc/config_local_site
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine -v --html --html-link-search --html-link-curate --curate --sqlite-update $SpinePOD/*
+,#+END_SRC
+
+,#+BEGIN_SRC yaml
+# sample resource configuration file ( $SpinePOD/.rc/config_local_site )
+output:
+  path:                        "/srv/www/spine"
+default:
+  language:                    "en"
+  papersize:                   "a4"
+  text_wrap:                   "80"
+  digest:                      "sha256"
+webserv:
+  http:                        "http"
+  domain:                      "localhost"
+  data_http:                   "http"
+  data_domain:                 "localhost"
+  data_root_url:               "https://sisudoc.org"
+  data_root_path:              "/srv/www/spine"
+  images_root_part:            "image"
+  cgi_search_form_title:       "≅ SiSU Spine search"
+  cgi_http:                    "https"
+  cgi_domain:                  "sisudoc.org"
+  cgi_bin_url:                 "http://sisudoc.org/cgi-bin"
+  cgi_bin_part:                "cgi-bin"
+  cgi_bin_path:                "/var/www/cgi/cgi-bin"
+  cgi_search_script:           "<<spine_search_cgi>>"
+  cgi_action:                  "https://sisudoc.org/spine_search"
+  db_sqlite_filename:          "<<spine_search_db>>"
+  db_sqlite_path:              "/var/www/sqlite"
+,#+END_SRC
+
+,*** make search form
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine -v --cgi-search-form-codegen --config=$SpinePOD/.dr/config_local_site
+,#+END_SRC
+
+,*** latex
+
+,#+BEGIN_SRC sh
+$SpineBIN/spine --latex --serial --output="$SpineOUT" $SpinePOD/*
+ls $SpineOutstatic/latex/*.tex
+,#+END_SRC
+' >> nixNote_.org
+
+#cat nixNote_.org
+
+#echo "emacs nixNote_.org"
+#echo "cat nixNote_.org"
+#+END_SRC
+
+*** makefile
+
+#+HEADER: :tangle-NO ../makefile_
+#+BEGIN_SRC make
+buildPhase:
+	HOME=$${PWD}; \
+	for DC_ in dmd ldmd2 gdmd; do \
+	  echo "- check for D compiler $${DC_}"; \
+	  DC=$$(type -P $${DC_} || echo ""); \
+	  if [ ! "$${DC}" == "" ]; then \
+	    break; \
+	  fi; \
+	done; \
+  echo "D compiler = $${DC}"; \
+	if [ "$${DC}" == "" ]; then \
+    echo "Error: could not find D compiler"; \
+	  exit 1; \
+	fi; \
+	echo "$${DC_} used as D compiler to build $${pname}"; \
+	export DFLAGS="-O2 -inline"; \
+	dub build --compiler=$${DC} --build=release --combined --skip-registry=all;
+checkPhase:
+	runHook preCheck; \
+	HOME=$${PWD}; \
+	dub test --combined --skip-registry=all; \
+	runHook postCheck
+installPhase:
+	runHook preInstall; \
+	mkdir -p $${out}/bin; \
+	install -m755 ./bin/spine $${out}/bin/spine; \
+	runHook postInstall
+	#cp -r bin/spine $out/bin/.
+postInstall:
+	echo "$${out}/share/cgi-bin"; \
+	echo `ls -la $${out}/bin/spine`
+#+END_SRC
diff --git a/shell.nix b/shell.nix
new file mode 100755
index 0000000..ad4bd50
--- /dev/null
+++ b/shell.nix
@@ -0,0 +1,24 @@
+#!/usr/bin/env -S nix-shell --pure
+#!nix-shell -i bash
+{ pkgs ? import <nixpkgs> {} }:
+let
+in pkgs.mkShell {
+  buildInputs = with pkgs; [
+    nix
+    bundler
+    bundix
+    #ruby
+    #rubyPackages.rake
+    #rubyPackages.sqlite3
+    #rubyPackages.thor
+    ruby_3_1
+    rubyPackages_3_1.rake
+    rubyPackages_3_1.sqlite3
+    rubyPackages_3_1.thor
+    sqlite
+    unzip
+    xz
+    zip
+    #texlive-combined-full
+  ];
+}