work on more generic install + instructions

1 files changed, 306 insertions, 155 deletions

diff --git a/org/spine_info.org b/org/spine_info.org
index 4cfa865..7d09b92 100644
--- a/org/spine_info.org
+++ b/org/spine_info.org
@@ -25,17 +25,15 @@
 #+HEADER: :tangle "../README"
 #+HEADER: :noweb yes
 #+BEGIN_SRC text
-<<sisu_spine_readme_org_header>>
+<<sisudoc_spine_readme_org_header>>
 
-<<sisu_spine_readme_info>>
+<<sisudoc_spine_readme_info>>
 
-<<sisu_spine_readme_install_org>>
+<<sisudoc_spine_readme_install_org>>
 
-<<sisu_spine_readme_configuration_org>>
+<<sisudoc_spine_readme_examples_org>>
 
-<<sisu_spine_readme_commands_org>>
-
-<<sisu_spine_readme_examples_org>>
+<<sisudoc_spine_readme_commands_org>>
 #+END_SRC
 
 *** md
@@ -43,20 +41,18 @@
 #+HEADER: :tangle "../README.md"
 #+HEADER: :noweb yes
 #+BEGIN_SRC text
-<<sisu_spine_readme_info>>
-
-<<sisu_spine_readme_install_md>>
+<<sisudoc_spine_readme_info>>
 
-<<sisu_spine_readme_configuration_md>>
+<<sisudoc_spine_readme_install_md>>
 
-<<sisu_spine_readme_commands_md>>
+<<sisudoc_spine_readme_examples_md>>
 
-<<sisu_spine_readme_examples_md>>
+<<sisudoc_spine_readme_commands_md>>
 #+END_SRC
 
 ** org header
 
-#+NAME: sisu_spine_readme_org_header
+#+NAME: sisudoc_spine_readme_org_header
 #+BEGIN_SRC text
 -*- mode: org -*-
 #+TITLE:       spine (sisudoc) (project) README
@@ -78,7 +74,7 @@
 
 ** project name
 
-#+NAME: sisu_spine_readme_info
+#+NAME: sisudoc_spine_readme_info
 #+BEGIN_SRC yaml
 project_name:  Spine, Doc Reform
 
@@ -106,72 +102,150 @@ project_name:  Spine, Doc Reform
 
 ** short description (currently UNUSED)
 
-#+NAME: sisu_spine_readme_description
+#+NAME: sisudoc_spine_readme_description
 #+BEGIN_SRC text
 #+END_SRC
 
 ** installation
 *** org
 
-#+NAME: sisu_spine_readme_install_org
+#+NAME: sisudoc_spine_readme_install_org
 #+HEADER: :noweb yes
 #+BEGIN_SRC text
-,* <<sisu_spine_readme_install_heading>>
+,* <<sisudoc_spine_readme_install_h1>>
+
+<<sisudoc_spine_readme_install_body_summary>>
+
+,** <<sisudoc_spine_readme_install_body_clone_h2>>
+
+<<sisudoc_spine_readme_install_body_clone>>
 
-<<sisu_spine_readme_install_body>>
+,** <<sisudoc_spine_readme_install_body_build_h2>>
+
+<<sisudoc_spine_readme_install_body_build>>
 #+END_SRC
 
 *** md
 
-#+NAME: sisu_spine_readme_install_md
+#+NAME: sisudoc_spine_readme_install_md
 #+HEADER: :noweb yes
 #+BEGIN_SRC markdown
-# <<sisu_spine_readme_install_heading>>
+## <<sisudoc_spine_readme_install_h1>>
+
+<<sisudoc_spine_readme_install_body_summary>>
+
+## <<sisudoc_spine_readme_install_body_clone_h2>>
+
+<<sisudoc_spine_readme_install_body_clone>>
+
+## <<sisudoc_spine_readme_install_body_build_h2>>
 
-<<sisu_spine_readme_install_body>>
+<<sisudoc_spine_readme_install_body_build>>
 #+END_SRC
 
 *** heading
 
-#+NAME: sisu_spine_readme_install_heading
+#+NAME: sisudoc_spine_readme_install_h1
 #+BEGIN_SRC text
 Installation, Compilation
 #+END_SRC
 
 *** text body
 
-#+NAME: sisu_spine_readme_install_body
+#+NAME: sisudoc_spine_readme_install_body_summary
 #+BEGIN_SRC markdown
-SiSU spine is written in the programming language D for which there are 3 compilers:
+Development of sisudoc-spine started in 2015 on a Debian linux box.
 
-- dmd
-- ldc
-- gdc
+Development since 2020 has been on a NixOS linux box, my laptop. If you are
+fortunate enough to be using the same the build instructions should be presented
+on entering the sisudoc-spine directory. It should be little problem building on
+other linuxes with the right dependencies. At one time, debconf-18 I was
+persuaded to try meson, and for a couple of years maintained a meson build, that
+dropped out of use before or on my making the switch to nixos in 2020.
+
+❯❯ D compiler and build manager
+
+SiSU spine is written in the programming language D for which there are 3
+compilers: dmd, ldc, gdc
+- https://wiki.dlang.org/Compilers
 
 D projects tend to use dub as project manager
-https://code.dlang.org/packages/dub
-https://code.dlang.org/packages/dub
-https://github.com/dlang/dub/blob/master/source/dub/commandline.d
+- https://code.dlang.org/packages/dub
+- https://github.com/dlang/dub/blob/master/source/dub/commandline.d
+
+The default build tools used are dub with ldc2 (dub is also tested)
+#+END_SRC
+
+#+NAME: sisudoc_spine_readme_install_body_clone_h2
+#+BEGIN_SRC markdown
+make a directory and clone the sisudoc-spine project-heading
+#+END_SRC
+
+#+NAME: sisudoc_spine_readme_install_body_clone
+#+BEGIN_SRC markdown
+# make a directory and clone the sisudoc-spine project
 
-  dub --compiler=ldc2 -color --config=ldc -b release
+  mkdir ~/git.sisudoc
+  cd ~/git.sisudoc
 
-  dub --compiler=dmd -color --config=dmd
+  git clone git://git.sisudoc.org/software/sisudoc-spine && \
+  git clone git://git.sisudoc.org/software/sisudoc-spine-search-cgi && \
+  git clone git://git.sisudoc.org/markup/sisudoc-spine-samples
 
-  dub --compiler=gdc-10 -color --config=gdc -b release
+such a relative directory layout will be assumed in the examples that provided
+#+END_SRC
+
+#+NAME: sisudoc_spine_readme_install_body_build_h2
+#+BEGIN_SRC markdown
+build sisudoc-spine
+#+END_SRC
+
+#+NAME: sisudoc_spine_readme_install_body_build
+#+BEGIN_SRC markdown
+## directly with dub
+### ldc2
+
+  dub --compiler=ldmd2 --config=ldmd2
+  dub --verbose --compiler=ldmd2 -color --config=ldmd2
+
+  dub --compiler=ldc2 --config=ldc2
+  dub --verbose --compiler=ldc2 -color --config=ldc2
+
+### dmd
+
+  dub --compiler=dmd --config=dmd
+
+## with make
+
+### ldc2
 
   make ldc
 
+### dmd
+
   make dmd
 
-there has been some coalescence around the Meson build system
-https://mesonbuild.com/
+## with nix on linux / nixos
 
-  meson
+### ldc2
 
-  ninja -C build
+  nix develop ".#dsh-nixpkgs-ldc-dub" --print-build-logs -c zsh
+  nix build ".#spine-nixpkgs-ldc" --print-build-logs
 
-  meson setup --wipe build && ninja -v -C build
+### dmd
+
+  nix develop ".#dsh-nixpkgs-dmd-dub" --print-build-logs -c zsh
+  nix build ".#spine-nixpkgs-dmd" --print-build-logs
+
+## the Meson build system was used briefly
+
+On recommendation at debconf-18 meson was used briefly. It has neither been tested nor used since the move to nix.
 
+- https://mesonbuild.com/
+
+  meson
+  ninja -C build
+  meson setup --wipe build && ninja -v -C build
   make meson
 
 dub --force --compiler=ldc2 && sudo cp -v cgi-bin/spine-search /usr/lib/cgi-bin/.
@@ -180,34 +254,34 @@ dub --force --compiler=ldc2 && sudo cp -v cgi-bin/spine-search /usr/lib/cgi-bin/
 ** configuration
 *** org
 
-#+NAME: sisu_spine_readme_configuration_org
+#+NAME: sisudoc_spine_readme_configuration_org
 #+HEADER: :noweb yes
 #+BEGIN_SRC text
-,* <<sisu_spine_readme_configuration_heading>>
+,* <<sisudoc_spine_readme_configuration_h1>>
 
-<<sisu_spine_readme_configuration_body>>
+<<sisudoc_spine_readme_configuration_body>>
 #+END_SRC
 
 *** md
 
-#+NAME: sisu_spine_readme_configuration_md
+#+NAME: sisudoc_spine_readme_configuration_md
 #+HEADER: :noweb yes
 #+BEGIN_SRC markdown
-# <<sisu_spine_readme_configuration_heading>>
+# <<sisudoc_spine_readme_configuration_h1>>
 
-<<sisu_spine_readme_configuration_body>>
+<<sisudoc_spine_readme_configuration_body>>
 #+END_SRC
 
 *** heading
 
-#+NAME: sisu_spine_readme_configuration_heading
+#+NAME: sisudoc_spine_readme_configuration_h1
 #+BEGIN_SRC text
 Configuration
 #+END_SRC
 
 *** text body
 
-#+NAME: sisu_spine_readme_configuration_body
+#+NAME: sisudoc_spine_readme_configuration_body
 #+BEGIN_SRC markdown
 Configuration files are yaml files
 
@@ -271,63 +345,71 @@ webserv:
 ** commands help
 *** org
 
-#+NAME: sisu_spine_readme_commands_org
+#+NAME: sisudoc_spine_readme_commands_org
 #+HEADER: :noweb yes
 #+BEGIN_SRC text
-,* <<sisu_spine_readme_commands_heading>>
+,* <<sisudoc_spine_readme_commands_h2>>
 
-<<sisu_spine_readme_commands_body>>
+<<sisudoc_spine_readme_commands_body>>
 #+END_SRC
 
 *** md
 
-#+NAME: sisu_spine_readme_commands_md
+#+NAME: sisudoc_spine_readme_commands_md
 #+HEADER: :noweb yes
 #+BEGIN_SRC markdown
-# <<sisu_spine_readme_commands_heading>>
+# <<sisudoc_spine_readme_commands_h2>>
 
-<<sisu_spine_readme_commands_body>>
+<<sisudoc_spine_readme_commands_body>>
 #+END_SRC
 
 *** heading
 
-#+NAME: sisu_spine_readme_commands_heading
+#+NAME: sisudoc_spine_readme_commands_h2
 #+BEGIN_SRC text
 Commands
 #+END_SRC
 
 *** text body
 
-#+NAME: sisu_spine_readme_commands_body
+#+NAME: sisudoc_spine_readme_commands_body
 #+BEGIN_SRC markdown
 for a list of commands from the program type:
 
   spine -h
 
 at the time of writing this provides the following output:
-
                   --abstraction document abstraction
+              --allow-downloads allow downloads (includes cgi.d from github)
                        --assert set optional assertions on
-      --cgi-search-form-codegen generates (pre-compiled) d code for search of specified db
-   --cgi-sqlite-search-filename =[filename]
+                 --cgi-bin-root path to cgi-bin directory
+                 --cgi-url-root url to cgi-bin (to find cgi-bin)
+               --cgi-url-action url to post to cgi-bin search form
+             --cgi-search-title if generating a cgi search form the title to use for it
+   --cgi-sqlite-search-filename =[filename] default is spine-search
                   --concordance file for document
-                       --config =/path/to/config/file/including/filename
+                       --curate extract info on authors & topics from document header metadata
+               --curate-authors extract info on authors from document header metadata
+                --curate-topics extract info on topics from document header metadata
                          --dark alternative dark theme
-                        --debug debug
                        --digest hash digest for each object
                          --epub process epub output
-                      --curate extract info on authors & topics from document header metadata
-              --curate-authors extract info on authors from document header metadata
-               --curate-topics extract info on topics from document header metadata
+                 --generated-by generated by headers (software version & time)
                      --hide-ocn object cite numbers
                          --html process html output
-            --html-link-curate place links back to curate in segmented html
+             --html-link-curate place links back to curate in segmented html
+             --html-link-markup provide html link to markup source, shared optionally
+                --html-link-pdf provide html link to pdf a4 & letter output
+             --html-link-pdf-a4 provide html link to pdf a4 output
+         --html-link-pdf-letter provide html link to pdf letter size output
              --html-link-search html embedded search submission
                      --html-seg process html output
                   --html-scroll process html output
                          --lang =[lang code e.g. =en or =en,es]
-                        --latex output for pdfs
+                        --latex latex output (for pdfs)
             --latex-color-links mono or color links for pdfs
+                   --latex-init initialise latex shared files (see latex-header-sty)
+             --latex-header-sty latex document header sty files
                         --light default light theme
                      --manifest process manifest output
                       --ocn-off object cite numbers
@@ -338,6 +420,7 @@ at the time of writing this provides the following output:
         --parallel-subprocesses nested parallelisation
                           --pdf latex output for pdfs
               --pdf-color-links mono or color links for pdfs
+                     --pdf-init initialise latex shared files (see latex-header-sty)
                           --pod spine (doc reform) pod source content bundled
 -q                      --quiet output to terminal
            --section-backmatter document backmatter (default)
@@ -351,18 +434,35 @@ at the time of writing this provides the following output:
                        --serial serial processing
                   --skip-output skip output
                   --show-config show config
+                  --show-curate show curate
+          --show-curate-authors show curate authors
+           --show-curate-topics show curate topics
+                    --show-epub show epub
+                    --show-html show html
+                   --show-latex show latex
                     --show-make show make
+                --show-manifest show manifest
                 --show-metadata show metadata
+                     --show-pod show pod
+                  --show-sqlite show sqlite
                  --show-summary show summary
                        --source document markup source
+                   --set-digest default hash digest type (e.g. sha256)
+                --set-papersize default papersize (latex pdf eg. a4 or a5 or b4 or letter)
+                 --set-textwrap default textwrap (e.g. 80 (characters)
               --sqlite-discrete process discrete sqlite output
              --sqlite-db-create create db, create tables
                --sqlite-db-drop drop tables & db
+           --sqlite-db-filename sqlite db to create, populate & make available for search
+               --sqlite-db-path sqlite db path
            --sqlite-db-recreate create db, create tables
                 --sqlite-delete sqlite output
-              --sqlite-db-filename =[filename].sql.db
                 --sqlite-insert sqlite output
                 --sqlite-update sqlite output
+                     --www-http http or https
+                     --www-host web server host (domain) name
+            --www-host-doc-root web host host (domain) name with path to doc root
+             --www-url-doc-root e.g. http://localhost
                          --text text output
                    --theme-dark alternative dark theme
                   --theme-light default light theme
@@ -371,93 +471,149 @@ at the time of writing this provides the following output:
                  --very-verbose output to terminal
                        --workon (reserved for some matters under development & testing)
                         --xhtml xhtml output
+                       --config =/path/to/config/file/including/filename
+                        --debug debug
+                 --debug-curate debug curate
+         --debug-curate-authors debug curate authors
+          --debug-curate-topics debug curate topics
+                   --debug-epub debug epub
+                --debug-harvest debug harvest
+                   --debug-html debug html
+                  --debug-latex debug latex
+               --debug-manifest debug manifest
+               --debug-metadata debug metadata
+                    --debug-pod debug pod
+                 --debug-sqlite debug sqlite
+                 --debug-stages debug stages
 -h                       --help This help information.
 #+END_SRC
 
 ** command examples
 *** text body org
 
-#+NAME: sisu_spine_readme_examples_org
+#+NAME: sisudoc_spine_readme_examples_org
 #+HEADER: :noweb yes
 #+BEGIN_SRC markdown
-,* Examples
+,* Document processing examples
+
+<<sisudoc_spine_readme_env_exports>>
+
+,*** html with links to search form
+
+<<sisudoc_spine_readme_examples_html_with_links_to_search_form_text>>
 
 ,** curate
 
-<<sisu_spine_readme_examples_curate_text>>
+<<sisudoc_spine_readme_examples_curate_text>>
 
 ,** sqlite
 
-<<sisu_spine_readme_examples_sqlite_text>>
+<<sisudoc_spine_readme_examples_sqlite_text>>
 
 ,*** create db
 
-<<sisu_spine_readme_examples_create_db_text>>
+<<sisudoc_spine_readme_examples_create_db_text>>
 
 ,*** populate db
 
-<<sisu_spine_readme_examples_populate_db_text>>
+<<sisudoc_spine_readme_examples_populate_db_text>>
 
 ,*** generate a cgi search form in d
 
-  <<sisu_spine_readme_examples_search_db_cgi_text>>
+  <<sisudoc_spine_readme_examples_search_db_cgi_text>>
 
 ,**** compile the cgi search form
 
-<<sisu_spine_readme_examples_compile_search_db_cgi_text>>
+<<sisudoc_spine_readme_examples_compile_search_db_cgi_text>>
 
 ,*** create db & search form
 
-  <<sisu_spine_readme_examples_create_db_and_search_form_text>>
+  <<sisudoc_spine_readme_examples_create_db_and_search_form_text>>
+#+END_SRC
 
-,*** html with links to search form
+*** env exports
 
-  <<sisu_spine_readme_examples_html_with_links_to_search_form_text>>
+#+NAME: sisudoc_spine_readme_env_exports
+#+BEGIN_SRC markdown
+These examples assume the file layout suggested in cloning the git.sisudoc.org
+repository, i.e. that the directories sisudoc-spine and sisudoc-spine-samples
+are next to each other on a directory tree. Assuming this to be the case, you
+may wish to set the following exports with adjustments accoring to your specific
+needs for these examples.
+
+# ❯❯ set spine binary location:
+export SpineBIN=./result/bin/spine
+# ❯❯ nix builds spine binary:
+#export SpineBIN=./result/bin/spine
+# ❯❯ dub builds spine binary (name depends on build, check):
+#export SpineBIN=./bin/spine
+#export SpineBIN=./bin/spine-ldc
+#export SpineBIN=./bin/spine-dmd
+# ❯❯ location of source files:
+export SpineDOC=../sisudoc-spine-samples
+# ❯❯ location of source files pod:
+export SpinePOD=${SpineDOC}/markup/pod
+# ❯❯ sisudoc-spine output processing path:
+export SpineOUT=./OUTPUT_TEST_sisudocSpine
+# ❯❯ sisudoc-spine output processing path (web server e.g.):
+#export SpineOUT=/srv/www/spine
+export SpineSearchActionLocal='http://localhost/spine_search'
+export SpineSearchActionRemote='https://sisudoc.org/spine_search'
+# ❯❯ path configured for cgi search form:
+export SpineCGIform='spine_search'
+# ❯❯ search form db name:
+export SpineSQLdb='spine.search.db'
+# ❯❯ configuration cgi search form path:
+#export SpineCGIbin=/var/www/cgi/cgi-bin
+# ❯❯ configuration db path:
+#export SpineDBpath=/var/www/sqlite
 #+END_SRC
 
 *** text body md
 
-#+NAME: sisu_spine_readme_examples_md
+#+NAME: sisudoc_spine_readme_examples_md
 #+HEADER: :noweb yes
 #+BEGIN_SRC markdown
-# Examples
+# Document processing examples
+
+<<sisudoc_spine_readme_env_exports>>
+
+### html with links to search form
+
+<<sisudoc_spine_readme_examples_html_with_links_to_search_form_text>>
 
 ## curate
 
-<<sisu_spine_readme_examples_curate_text>>
+<<sisudoc_spine_readme_examples_curate_text>>
 
 ## sqlite
 
-<<sisu_spine_readme_examples_sqlite_text>>
+<<sisudoc_spine_readme_examples_sqlite_text>>
 
 ### create db
 
-<<sisu_spine_readme_examples_create_db_text>>
+<<sisudoc_spine_readme_examples_create_db_text>>
 
 ### populate db
 
-<<sisu_spine_readme_examples_populate_db_text>>
+<<sisudoc_spine_readme_examples_populate_db_text>>
 
 ### generate a cgi search form in d
 
-  <<sisu_spine_readme_examples_search_db_cgi_text>>
+  <<sisudoc_spine_readme_examples_search_db_cgi_text>>
 
 #### compile the cgi search form
 
-<<sisu_spine_readme_examples_compile_search_db_cgi_text>>
+<<sisudoc_spine_readme_examples_compile_search_db_cgi_text>>
 
 ### create db & search form
 
-  <<sisu_spine_readme_examples_create_db_and_search_form_text>>
-
-### html with links to search form
-
-  <<sisu_spine_readme_examples_html_with_links_to_search_form_text>>
+  <<sisudoc_spine_readme_examples_create_db_and_search_form_text>>
 #+END_SRC
 
 *** text body content
 
-#+NAME: sisu_spine_readme_examples_curate_text
+#+NAME: sisudoc_spine_readme_examples_curate_text
 #+BEGIN_SRC text
 if you have a document collection with documents that have metadata headers a
 summary of the collection can be made using the curate command
@@ -471,7 +627,7 @@ summary of the collection can be made using the curate command
   spine -v --html --html-link-search --html-link-curate --curate ~spineMarkupSamples/pod/*
 #+END_SRC
 
-#+NAME: sisu_spine_readme_examples_sqlite_text
+#+NAME: sisudoc_spine_readme_examples_sqlite_text
 #+BEGIN_SRC text
 if configuartion has been set specify just
 - the desired output and
@@ -479,7 +635,7 @@ if configuartion has been set specify just
 
   spine -v --html ~spineMarkupSamples/markup/pod/sisu-manual
 
-if configuartion has not been set or to overide the set configration specify
+if configuration has not been set or to overide the set configuration specify
 - the output path as well as
 - the desired output and
 - the markup document/pod(s) to process
@@ -493,7 +649,7 @@ note: ~webDocRoot should be the path to web doc root, provide a suitable output
   spine -v --html --epub --latex --odt --curate --output=`echo ~webDocRoot` ~spineMarkupSamples/pod/*
 #+END_SRC
 
-#+NAME: sisu_spine_readme_examples_create_db_text
+#+NAME: sisudoc_spine_readme_examples_create_db_text
 #+BEGIN_SRC text
 if there is no sqlite db you first need to create one, to do so
 - the name of the db and
@@ -513,7 +669,7 @@ for a document collection you can point to the document collection:
   spine -v --sqlite-db-create ~spineMarkupSamples/pod
 #+END_SRC
 
-#+NAME: sisu_spine_readme_examples_populate_db_text
+#+NAME: sisudoc_spine_readme_examples_populate_db_text
 #+BEGIN_SRC text
 must specify:
 - the name of the db and
@@ -532,7 +688,7 @@ for a document collection you can point to the document collection:
   spine -v --sqlite-update ~spineMarkupSamples/pod/*
 #+END_SRC
 
-#+NAME: sisu_spine_readme_examples_search_db_cgi_text
+#+NAME: sisudoc_spine_readme_examples_search_db_cgi_text
 #+BEGIN_SRC text
 spine -v --cgi-search-form-codegen \
   --output=/var/www/html \
@@ -553,7 +709,7 @@ spine -v --cgi-search-form-codegen \
   ~spineMarkupSamples/pod
 #+END_SRC
 
-#+NAME: sisu_spine_readme_examples_compile_search_db_cgi_text
+#+NAME: sisudoc_spine_readme_examples_compile_search_db_cgi_text
 #+BEGIN_SRC text
   cd /var/www/html/cgi # /var/www/html (default document root)
 
@@ -577,9 +733,12 @@ cgi-bin directory
   spine -v --html --html-link-search --output=`echo ~webDocRoot` ~spineMarkupSamples/pod/*
 
   spine -v --html --html-link-search --cgi-sqlite-search-filename="spine-search" --html-link-curate --curate --output=`echo ~webDocRoot` ~spineMarkupSamples/pod/*
+
+  ${SpineBIN} -v --source --pod --latex --latex-init --epub --html --html-link-search --html-link-pdf --html-link-curate --html-link-markup --cgi-sqlite-search-filename="${SpineCGIform}" --cgi-url-action="${SpineSearchActionLocal}" --curate --sqlite-update --sqlite-db-filename="${SpineSQLdb}" --output=${SpineOUT} ${SpinePOD}/*
+
 #+END_SRC
 
-#+NAME: sisu_spine_readme_examples_create_db_and_search_form_text
+#+NAME: sisudoc_spine_readme_examples_create_db_and_search_form_text
 #+BEGIN_SRC text
 spine -v \
   --sqlite-db-create --sqlite-db-filename="spine.search.db" \
@@ -588,12 +747,18 @@ spine -v \
   ~spineMarkupSamples/pod/*
 #+END_SRC
 
-#+NAME: sisu_spine_readme_examples_html_with_links_to_search_form_text
+#+NAME: sisudoc_spine_readme_examples_html_with_links_to_search_form_text
 #+BEGIN_SRC text
+${SpineBIN} -v --epub --html --html-link-curate --curate --output=${SpineOUT} ${SpinePOD}/*
+
+${SpineBIN} -v --source --pod --latex --latex-init --epub --html --html-link-pdf --html-link-curate --html-link-markup --curate --output=${SpineOUT} ${SpinePOD}/*
+
+${SpineBIN} -v --source --pod --latex --latex-init --epub --html --html-link-search --html-link-pdf --html-link-curate --html-link-markup --cgi-sqlite-search-filename="${SpineCGIform}" --cgi-url-action="${SpineSearchActionLocal}" --curate --sqlite-update --sqlite-db-filename="${SpineSQLdb}" --output=${SpineOUT} ${SpinePOD}/*
+
 spine -v --html \
   --html-link-search \
   --output=`echo ~webDocRoot` \
-  ~spineMarkupSamples/pod/*
+  ${SpinePOD}/*
 #+END_SRC
 
 * manpage :manpage:
@@ -602,21 +767,21 @@ spine -v --html \
 #+HEADER: :tangle "../doc/man/man1/spine.1"
 #+HEADER: :noweb yes
 #+BEGIN_SRC  man
-<<sisu_spine_manpage_head>>
-<<sisu_spine_manpage_description>>
-<<sisu_spine_manpage_flags>>
-<<sisu_spine_manpage_flags_db>>
-<<sisu_spine_manpage_config>>
-<<sisu_spine_manpage_pod_dir_structure>>
-<<sisu_spine_manpage_cli_examples>>
-<<sisu_spine_manpage_docs>>
-<<sisu_spine_manpage_markup>>
+<<sisudoc_spine_manpage_head>>
+<<sisudoc_spine_manpage_description>>
+<<sisudoc_spine_manpage_flags>>
+<<sisudoc_spine_manpage_flags_db>>
+<<sisudoc_spine_manpage_config>>
+<<sisudoc_spine_manpage_pod_dir_structure>>
+<<sisudoc_spine_manpage_cli_examples>>
+<<sisudoc_spine_manpage_docs>>
+<<sisudoc_spine_manpage_markup>>
 #+END_SRC
 
 ** manpage
 *** head
 
-#+NAME: sisu_spine_manpage_head
+#+NAME: sisudoc_spine_manpage_head
 #+BEGIN_SRC  man
 .TH "spine" "1" "2020-04-05" "0.10.0" "Spine"
 .br
@@ -638,7 +803,7 @@ sisu --pg (--createdb|update [filename/wildcard]|--dropall)
 
 *** description
 
-#+NAME: sisu_spine_manpage_description
+#+NAME: sisudoc_spine_manpage_description
 #+BEGIN_SRC  man
 .SH SISU - MANUAL,
 RALPH AMISSAH
@@ -738,7 +903,7 @@ document structure information. For more see: <https://sisudoc.org> or
 ** flags
 *** general
 
-#+NAME: sisu_spine_manpage_flags
+#+NAME: sisudoc_spine_manpage_flags
 #+BEGIN_SRC  man
 .SH DOCUMENT PROCESSING COMMAND FLAGS
 
@@ -1047,7 +1212,7 @@ Produce output without identifying numbers in margins of html or
 
 *** db flags
 
-#+NAME: sisu_spine_manpage_flags_db
+#+NAME: sisudoc_spine_manpage_flags_db
 #+BEGIN_SRC  man
 .SH DATABASE COMMANDS
 
@@ -1116,7 +1281,7 @@ The -v is for verbose output.
 
 ** configuration file
 
-#+NAME: sisu_spine_manpage_config
+#+NAME: sisudoc_spine_manpage_config
 #+BEGIN_SRC  man
 .SH CONFIGURATION
 
@@ -1167,7 +1332,7 @@ webserv:
 
 ** sample pod directory
 
-#+NAME: sisu_spine_manpage_pod_dir_structure
+#+NAME: sisudoc_spine_manpage_pod_dir_structure
 #+BEGIN_SRC  man
 .SH SAMPLE POD DIRECTORY STRUCTURE
 .BR
@@ -1200,7 +1365,7 @@ pod (directory may contain multiple documents)
 
 ** examples
 
-#+NAME: sisu_spine_manpage_cli_examples
+#+NAME: sisudoc_spine_manpage_cli_examples
 #+BEGIN_SRC  man
 .SH COMMAND LINE EXAMPLES
 
@@ -1236,7 +1401,7 @@ dub --force --compiler=ldc2 && sudo cp -v cgi-bin/spine-search /usr/lib/cgi-bin/
 ** docs
 *** sources
 
-#+NAME: sisu_spine_manpage_docs
+#+NAME: sisudoc_spine_manpage_docs
 #+BEGIN_SRC  man
 
 .BR
@@ -1311,7 +1476,7 @@ Available man pages are converted back to html using man2html:
 
 *** markup
 
-#+NAME: sisu_spine_manpage_markup
+#+NAME: sisudoc_spine_manpage_markup
 #+BEGIN_SRC  man
 .SH INTRODUCTION TO SISU MARKUP[^3]
 
@@ -4728,15 +4893,15 @@ matches are found.
 #+HEADER: :noweb yes
 #+BEGIN_SRC txt
 - Name: spine - SiSU Spine, Doc Reform
-  <<sisu_spine_copyright>>
+  <<sisudoc_spine_copyright>>
 
-  <<sisu_spine_license_agpl3>>
+  <<sisudoc_spine_license_agpl3>>
 
-  <<sisu_spine_summary>>
+  <<sisudoc_spine_summary>>
 
-<<sisu_spine_markup_samples>>
+<<sisudoc_spine_markup_samples>>
 
-<<sisu_spine_dependencies>>
+<<sisudoc_spine_dependencies>>
 #+END_SRC
 
 *** code source ./src
@@ -4745,15 +4910,15 @@ matches are found.
 #+HEADER: :noweb yes
 #+BEGIN_SRC txt
 - Name: spine - SiSU Spine, Doc Reform
-  <<sisu_spine_copyright>>
+  <<sisudoc_spine_copyright>>
 
-  <<sisu_spine_license_agpl3>>
+  <<sisudoc_spine_license_agpl3>>
 
-  <<sisu_spine_summary>>
+  <<sisudoc_spine_summary>>
 
-<<sisu_spine_markup_samples>>
+<<sisudoc_spine_markup_samples>>
 
-<<sisu_spine_dependencies>>
+<<sisudoc_spine_dependencies>>
 #+END_SRC
 
 *** code source ./src/sisudoc
@@ -4762,15 +4927,15 @@ matches are found.
 #+HEADER: :noweb yes
 #+BEGIN_SRC txt
 - Name: spine - SiSU Spine, Doc Reform
-  <<sisu_spine_copyright>>
+  <<sisudoc_spine_copyright>>
 
-  <<sisu_spine_license_agpl3>>
+  <<sisudoc_spine_license_agpl3>>
 
-  <<sisu_spine_summary>>
+  <<sisudoc_spine_summary>>
 
-<<sisu_spine_markup_samples>>
+<<sisudoc_spine_markup_samples>>
 
-<<sisu_spine_dependencies>>
+<<sisudoc_spine_dependencies>>
 #+END_SRC
 
 *** org files ./org
@@ -4785,11 +4950,11 @@ matches are found.
 #+HEADER: :noweb yes
 #+BEGIN_SRC txt
 - Name: spine - SiSU Spine, Doc Reform
-  <<sisu_spine_copyright>>
+  <<sisudoc_spine_copyright>>
 
-  <<sisu_spine_summary>>
+  <<sisudoc_spine_summary>>
 
-<<sisu_spine_markup_samples>>
+<<sisudoc_spine_markup_samples>>
 #+END_SRC
 
 *** doc (markup samples) ./doc
@@ -4803,7 +4968,7 @@ matches are found.
 ** incorporate
 *** copyright
 
-#+NAME: sisu_spine_copyright
+#+NAME: sisudoc_spine_copyright
 #+BEGIN_SRC txt
 - Description: documents, structuring, processing, publishing, search
   - static content generator
@@ -4817,7 +4982,7 @@ matches are found.
 *** license
 **** AGPLv3
 
-#+NAME: sisu_spine_license_agpl3
+#+NAME: sisudoc_spine_license_agpl3
 #+BEGIN_SRC txt
 - code under src/* src/sisudoc/*
   - License: AGPL 3 or later:
@@ -4848,7 +5013,7 @@ matches are found.
 
 *** spine_summary
 
-#+NAME: sisu_spine_summary
+#+NAME: sisudoc_spine_summary
 #+BEGIN_SRC txt
 - Spine, Doc Reform (related to SiSU) uses standard:
   - docReform markup syntax (based on SiSU markup)
@@ -4872,7 +5037,7 @@ matches are found.
 
 *** markup_samples
 
-#+NAME: sisu_spine_markup_samples
+#+NAME: sisudoc_spine_markup_samples
 #+BEGIN_SRC txt
 - Spine, Doc Reform (SiSU) markup samples
   Individual document content Copyright (Author) [as stated in document header]
@@ -4881,7 +5046,7 @@ matches are found.
 
 *** dependencies
 
-#+NAME: sisu_spine_dependencies
+#+NAME: sisudoc_spine_dependencies
 #+BEGIN_SRC txt
 - Dependencies [check dub.json or dub.sdl]
 
@@ -4986,20 +5151,6 @@ matches are found.
     [https://github.com/adamdruppe/arsd]
 
   - sundry/spine_search_cgi/src/ext_depends_cgi/arsd
-
-- Name: dub2nix
-  - Description:
-
-  - Author:
-    [Lionello Lunesu]
-
-  - Copyright: (C) 2019 Lionello Lunesu
-
-  - code: mkDub.nix (modified as needed)
-    - License: MIT License
-
-  - Homepages:
-    [https://github.com/lionello/dub2nix]
 #+END_SRC
 
 * CHANGELOG :changelog: