-*- mode: org -*-
#+TITLE: spine (doc_reform) hub
#+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 - 2021 Ralph Amissah
#+LANGUAGE: en
#+STARTUP: content hideblocks hidestars noindent entitiespretty
#+OPTIONS: H:3 num:nil toc:t \n:nil @:t ::t |:t ^:nil _:nil -:t f:t *:t <:t
#+PROPERTY: header-args :exports code
#+PROPERTY: header-args+ :noweb yes
#+PROPERTY: header-args+ :eval no
#+PROPERTY: header-args+ :results no
#+PROPERTY: header-args+ :cache no
#+PROPERTY: header-args+ :padline no
[[./spine.org][spine.org]] [[../org/][org/]]
[[./spine_build_scaffold.org][make/build]]
* cgi search
cd util/d/cgi/search
dub --force --compiler=ldc2 && sudo cp -v cgi-bin/spine-search /usr/lib/cgi-bin/.
** 0. set program tangle
*** output cgi program
- compile spine
make ldc
- create db
~dr/bin/spine-ldc -v \
--sqlite-db-create --sqlite-db-filename="spine.search.db" \
--output=/var/www/html \
~grotto/repo/git.repo/code/project-spine/doc-reform-markup/markup_samples/markup/pod/*
- update db
~dr/bin/spine-ldc -v --sqlite-update --sqlite-db-filename="spine.search.db" \
--output=/var/www/html \
~grotto/repo/git.repo/code/project-spine/doc-reform-markup/markup_samples/markup/pod/*
- create search form d
~dr/bin/spine-ldc -v --cgi-search-form-codegen \
--output=/var/www/html \
~grotto/repo/git.repo/code/project-spine/doc-reform-markup/markup_samples/markup/pod
~dr/bin/spine-ldc -v --cgi-search-form-codegen \
--sqlite-db-filename="spine.search.db" \
--cgi-sqlite-search-filename="spine-search" \
--output=/var/www/html \
~grotto/repo/git.repo/code/project-spine/doc-reform-markup/markup_samples/markup/pod
- create db & search form
~dr/bin/spine-ldc -v \
--sqlite-db-create --sqlite-db-filename="spine.search.db" \
--cgi-search-form-codegen --cgi-sqlite-search-filename="spine-search" \
--output=/var/www/html \
~grotto/repo/git.repo/code/project-spine/doc-reform-markup/markup_samples/markup/pod/*
- compile cgi search form
cd /var/www/html/cgi # /var/www/html (default document root)
dub --force --compiler=ldc2 && sudo cp -v cgi-bin/spine-search /usr/lib/cgi-bin/.
- html
~dr/bin/spine-ldc -v --html --html-link-search \
--output=/var/www/html \
~grotto/repo/git.repo/code/project-spine/doc-reform-markup/markup_samples/markup/pod/*
#+BEGIN_SRC d :tangle "../src/doc_reform/io_out/cgi_sqlite_search_form.d"
<>
module doc_reform.io_out.cgi_sqlite_search_form;
template CGIsearchSQLite() {
void CGIsearchSQLite(E,O,M)(E env, O opt_action, M make_and_meta_struct) {
import
std.file,
std.format;
import doc_reform.io_out;
string _sqlite_db_fn = (opt_action.sqlite_filename.empty)
? make_and_meta_struct.conf.w_srv_db_sqlite
: opt_action.sqlite_filename;
string _cgi_search_script = (opt_action.cgi_sqlite_search_filename.empty)
? make_and_meta_struct.conf.w_srv_cgi_search_script
: opt_action.cgi_sqlite_search_filename;
string _cgi_search_script_raw_fn_d = (opt_action.cgi_sqlite_search_filename_d.empty)
? make_and_meta_struct.conf.w_srv_cgi_search_script_raw_fn_d
: opt_action.cgi_sqlite_search_filename_d;
string get_doc_collection_sub_root(string output_path) {
string web_doc_root_path = environment.get("DOCUMENT_ROOT", "/var/www/html");
auto m = output_path.matchFirst(regex("^(" ~ web_doc_root_path ~ ")"));
return m.post;
}
string the_cgi_search_form = format(q"≓
<>
<>
void cgi_function_intro(Cgi cgi) {
<>
<>
<>
cv.db_selected = "%s";
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
"%s",
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
<>
}
mixin GenericMain!cgi_function_intro;
≓",
get_doc_collection_sub_root(make_and_meta_struct.conf.output_path),
make_and_meta_struct.conf.output_path ~ "/sqlite/",
_sqlite_db_fn,
(opt_action.cgi_search_title.empty)
? make_and_meta_struct.conf.w_srv_cgi_search_title
: opt_action.cgi_search_title,
(opt_action.css_theme_default) ? "FFFFFF" : "000000",
(opt_action.css_theme_default) ? "000000" : "CCCCCC",
(opt_action.css_theme_default) ? "FFFFFF" : "000000",
(opt_action.css_theme_default) ? "FFFFFF" : "000000",
(opt_action.css_theme_default) ? "003399" : "FFFFFF",
(opt_action.css_theme_default) ? "003399" : "999999",
"000000",
(opt_action.css_theme_default) ? "F9F9AA" : "555555",
(opt_action.css_theme_default) ? "777777" : "BBBBBB",
(opt_action.css_theme_default) ? "32CD32" : "9ACD32",
(opt_action.css_theme_default) ? "777777" : "BBBBBB",
(opt_action.css_theme_default) ? "FFFFFF" : "000000",
(opt_action.css_theme_default) ? "003399" : "888888",
(opt_action.css_theme_default) ? "000000" : "FFFFFF",
(opt_action.css_theme_default) ? "FFFFFF" : "777777",
(opt_action.css_theme_default) ? "000000" : "FFFF48",
(opt_action.css_theme_default) ? "FFFF48" : "777748",
(opt_action.cgi_search_title.empty)
? make_and_meta_struct.conf.w_srv_cgi_search_title
: opt_action.cgi_search_title,
(opt_action.css_theme_default) ? "222222" : "AAAAAA",
_cgi_search_script,
_sqlite_db_fn,
).strip;
string _cgi_path = (opt_action.output_dir_set.length > 0)
? opt_action.output_dir_set
: (make_and_meta_struct.conf.w_srv_data_root_path.length > 0)
? make_and_meta_struct.conf.w_srv_data_root_path
: "";
auto pth_sqlite_cgi = spinePathsSQLiteCGI!()(_cgi_search_script_raw_fn_d, _cgi_search_script, _cgi_path);
{ // cgi-bin search form src d
try {
if (!exists(pth_sqlite_cgi.src)) {
pth_sqlite_cgi.src.mkdirRecurse;
}
if (!exists(pth_sqlite_cgi.cgi_bin)) {
pth_sqlite_cgi.cgi_bin.mkdirRecurse;
}
auto f = File(pth_sqlite_cgi.search_form_path_out, "w");
f.write(the_cgi_search_form);
// foreach (o; metadata_) {
// f.writeln(o);
// }
} catch (ErrnoException ex) {
// Handle error
}
// if (!(opt_action.quiet)) {
// writeln(" ", pth_sqlite_cgi.search_form);
// }
}
string the_dub_sdl = format(q"≓
<>
≓",
"~>0.18.3", // d2sqlite3 dependency version
"~>7.2.0", // arsd-official:cgi dependency version
"src/" ~ _cgi_search_script_raw_fn_d,
_cgi_search_script
).strip;
{ // dub.sdl
try {
auto f = File(pth_sqlite_cgi.dub_sdl_path_out, "w");
f.write(the_dub_sdl);
// foreach (o; metadata_) {
// f.writeln(o);
// }
} catch (ErrnoException ex) {
// Handle error
}
}
// { // get cgi.d
// // import std.net.curl, std.stdio;
// // char[] cgi_d;
// // if (opt_action.allow_downloads) {
// // try {
// // cgi_d = get!HTTP("https://raw.githubusercontent.com/adamdruppe/arsd/master/cgi.d");
// // } catch (ErrnoException ex) {
// // // Handle error
// // // CurlCode perform(ThrowOnError throwOnError = Yes.throwOnError);
// // CurlCode perform(ThrowOnError throwOnError = No.throwOnError);
// // }
// // if (cgi_d && cgi_d.length > 0) {
// // try {
// // auto f = File(pth_sqlite_cgi.cgi_d_path_out, "w");
// // f.write(cgi_d);
// // } catch (ErrnoException ex) {
// // // Handle error
// // }
// // }
// // }
// }
}
}
#+END_SRC
** header
#+NAME: cgi_sqlite_head
#+BEGIN_SRC d
/+ dub.sdl
name "spine search"
description "spine cgi search"
+/
#+END_SRC
** imports
#+NAME: cgi_sqlite_imports
#+BEGIN_SRC d
import std.format;
import std.range;
import std.regex;
import arsd.cgi;
import d2sqlite3;
import std.process : environment;
#+END_SRC
** void main
*** initialize
#+NAME: cgi_sqlite_initialize_head
#+BEGIN_SRC d
string header;
string table;
string form;
#+END_SRC
**** config
#+NAME: cgi_sqlite_initialize_config
#+BEGIN_SRC d
struct Config {
string http_request_type;
string http_host;
// string server_name;
string web_doc_root_path;
string doc_collection_sub_root;
string cgi_root;
string cgi_script;
string data_path_html;
string db_path;
string query_string;
string http_url;
string request_method;
}
auto conf = Config();
conf.http_request_type = environment.get("REQUEST_SCHEME", "http");
conf.http_host = environment.get("HTTP_HOST", "localhost");
// conf.server_name = environment.get("SERVER_NAME", "localhost");
conf.web_doc_root_path = environment.get("DOCUMENT_ROOT", "/var/www/html");
conf.doc_collection_sub_root = "%s"; // (output_path - web_doc_root_path)
conf.cgi_root = environment.get("CONTEXT_DOCUMENT_ROOT", "/usr/lib/cgi-bin/");
// conf.cgi_script = environment.get("SCRIPT_NAME", "/cgi-bin/spine-search");
conf.query_string = environment.get("QUERY_STRING", "");
conf.http_url = environment.get("HTTP_REFERER", conf.http_request_type ~ "://" ~ conf.http_host ~ conf.cgi_script ~ "?" ~ conf.query_string);
conf.db_path = "%s"; // (output_path + /sqlite)
conf.request_method = environment.get("REQUEST_METHOD", "POST");
#+END_SRC
# REQUEST_URI QUERY_STRING
**** cgi val
#+NAME: cgi_sqlite_initialize_cgi_val
#+BEGIN_SRC d
struct CGI_val {
string db_selected = "";
string sql_match_limit = ""; // radio: ( 1000 | 2500 )
string sql_match_offset = "";
string search_text = "";
string results_type = ""; // index
bool checked_echo = false;
bool checked_stats = false;
bool checked_url = false;
bool checked_searched = false;
bool checked_tip = false;
bool checked_sql = false;
}
auto cv = CGI_val();
#+END_SRC
**** text fields
***** open
#+NAME: cgi_sqlite_initialize_text
#+BEGIN_SRC d
auto text_fields() {
string canned_query_str = environment.get("QUERY_STRING", "");
if ("query_string" in cgi.post) {
canned_query_str = environment.get("QUERY_STRING", "");
}
string[string] canned_query;
if (conf.request_method == "POST") {
} else if (conf.request_method == "GET") {
foreach (pair_str; canned_query_str.split("&")) {
// cgi.write(pair_str ~ " ");
string[] pair = pair_str.split("=");
canned_query[pair[0]] = pair[1];
}
// foreach (field, content; canned_query) {
// cgi.write(field ~ ": " ~ content ~ " ");
// }
}
#+END_SRC
***** rgx
#+NAME: cgi_sqlite_initialize_rgx
#+BEGIN_SRC d
static struct Rgx {
// static canned_query = ctRegex!(`\A(?P.+)\Z`, "m");
static search_text_area = ctRegex!(`\A(?P.+)\Z`, "m");
// static fulltext = ctRegex!(`\A(?P.+)\Z`, "m");
static line = ctRegex!(`^(?P.+?)(?: ~|$)`, "m");
static text = ctRegex!(`(?:^|\s~\s*)text:\s+(?P.+?)(?: ~|$)`, "m");
static author = ctRegex!(`(?:^|\s~\s*)author:\s+(?P.+)$`, "m");
static title = ctRegex!(`(?:^|\s~\s*)title:\s+(?P.+)$`, "m");
static uid = ctRegex!(`(?:^|\s~\s*)uid:\s+(?P.+)$`, "m");
static fn = ctRegex!(`(?:^|\s~\s*)fn:\s+(?P.+)$`, "m");
static keywords = ctRegex!(`(?:^|\s~\s*)keywords:\s+(?P.+)$`, "m");
static topic_register = ctRegex!(`(?:^|\s~\s*)topic_register:\s+(?P.+)$`, "m");
static subject = ctRegex!(`(?:^|\s~\s*)subject:\s+(?P.+)$`, "m");
static description = ctRegex!(`(?:^|\s~\s*)description:\s+(?P.+)$`, "m");
static publisher = ctRegex!(`(?:^|\s~\s*)publisher:\s+(?P.+)$`, "m");
static editor = ctRegex!(`(?:^|\s~\s*)editor:\s+(?P.+)$`, "m");
static contributor = ctRegex!(`(?:^|\s~\s*)contributor:\s+(?P.+)$`, "m");
static date = ctRegex!(`(?:^|\s~\s*)date:\s+(?P.+)$`, "m");
static results_type = ctRegex!(`(?:^|\s~\s*)type:\s+(?P.+)$`, "m");
static format = ctRegex!(`(?:^|\s~\s*)format:\s+(?P.+)$`, "m");
static source = ctRegex!(`(?:^|\s~\s*)source:\s+(?P.+)$`, "m");
static language = ctRegex!(`(?:^|\s~\s*)language:\s+(?P.+)$`, "m");
static relation = ctRegex!(`(?:^|\s~\s*)relation:\s+(?P.+)$`, "m");
static coverage = ctRegex!(`(?:^|\s~\s*)coverage:\s+(?P.+)$`, "m");
static rights = ctRegex!(`(?:^|\s~\s*)rights:\s+(?P.+)$`, "m");
static comment = ctRegex!(`(?:^|\s~\s*)comment:\s+(?P.+)$`, "m");
// static abstract_ = ctRegex!(`(?:^|\s~\s*)abstract:\s+(?P.+)$`, "m");
static src_filename_base = ctRegex!(`^src_filename_base:\s+(?P.+)$`, "m");
}
#+END_SRC
***** searchfields
#+NAME: cgi_sqlite_initialize_fields
#+BEGIN_SRC d
struct searchFields {
string canned_query = ""; // GET canned_query == cq
string search_text_area = ""; // POST search_text_area == tsa
string text = ""; // text == txt
string author = ""; // author == au
string title = ""; // title == ti
string uid = ""; // uid == uid
string fn = ""; // fn == fn
string keywords = ""; // keywords == kw
string topic_register = ""; // topic_register == tr
string subject = ""; // subject == su
string description = ""; // description == de
string publisher = ""; // publisher == pb
string editor = ""; // editor == ed
string contributor = ""; // contributor == ct
string date = ""; // date == dt
string format = ""; // format == fmt
string source = ""; // source == src sfn
string language = ""; // language == lng
string relation = ""; // relation == rl
string coverage = ""; // coverage == cv
string rights = ""; // rights == rgt
string comment = ""; // comment == cmt
// string abstract = "";
string src_filename_base = ""; // src_filename_base == bfn
string results_type = ""; // results_type == rt radio
string sql_match_limit = ""; // sql_match_limit == sml radio
string sql_match_offset = ""; // sql_match_offset == smo
string stats = ""; // stats == sts checked
string echo = ""; // echo == ec checked
string url = ""; // url == url checked
string searched = ""; // searched == se checked
string sql = ""; // sql == sql checked
}
auto rgx = Rgx();
auto got = searchFields();
#+END_SRC
***** env
****** POST
#+NAME: cgi_sqlite_initialize_env_0
#+BEGIN_SRC d
if (environment.get("REQUEST_METHOD", "POST") == "POST") {
if ("sf" in cgi.post) {
got.search_text_area = cgi.post["sf"];
if (auto m = got.search_text_area.matchFirst(rgx.text)) {
got.text = m["matched"];
got.canned_query ~= "sf=" ~ m["matched"];
} else if (auto m = got.search_text_area.matchFirst(rgx.line)) {
if (
!(m["matched"].matchFirst(rgx.author))
&& !(m["matched"].matchFirst(rgx.title))
) {
got.text = m["matched"];
got.canned_query ~= "sf=" ~ m["matched"];
}
}
if (auto m = got.search_text_area.matchFirst(rgx.author)) {
got.author = m["matched"];
got.canned_query ~= "&au=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.title)) {
got.title = m["matched"];
got.canned_query ~= "&ti=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.uid)) {
got.uid = m["matched"];
got.canned_query ~= "&uid=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.fn)) {
got.fn = m["matched"];
got.canned_query ~= "&fn=" ~ m["matched"];
} else if ("fn" in cgi.post) {
got.search_text_area ~= "\nfn: " ~ cgi.post["fn"] ~ "\n";
}
if (auto m = got.search_text_area.matchFirst(rgx.keywords)) {
got.keywords = m["matched"];
got.canned_query ~= "&kw=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.topic_register)) {
got.topic_register = m["matched"];
got.canned_query ~= "&tr=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.subject)) {
got.subject = m["matched"];
got.canned_query ~= "&su=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.description)) {
got.description = m["matched"];
got.canned_query ~= "&de=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.publisher)) {
got.publisher = m["matched"];
got.canned_query ~= "&pb=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.editor)) {
got.editor = m["matched"];
got.canned_query ~= "&ed=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.contributor)) {
got.contributor = m["matched"];
got.canned_query ~= "&ct=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.date)) {
got.date = m["matched"];
got.canned_query ~= "&dt=" ~ m["matched"];
}
// if (auto m = got.search_text_area.matchFirst(rgx.results_type)) {
// got.results_type = m["matched"];
// got.canned_query ~= "&rt=" ~ m["matched"];
// }
if (auto m = got.search_text_area.matchFirst(rgx.format)) {
got.format = m["matched"];
got.canned_query ~= "&fmt=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.source)) {
got.source = m["matched"];
got.canned_query ~= "&src=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.language)) {
got.language = m["matched"];
got.canned_query ~= "&lng=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.relation)) {
got.relation = m["matched"];
got.canned_query ~= "&rl=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.coverage)) {
got.coverage = m["matched"];
got.canned_query ~= "&cv=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.rights)) {
got.rights = m["matched"];
got.canned_query ~= "&rgt=" ~ m["matched"];
}
if (auto m = got.search_text_area.matchFirst(rgx.comment)) {
got.comment = m["matched"];
got.canned_query ~= "&cmt=" ~ m["matched"];
}
// if (auto m = search_text_area.matchFirst(rgx.abstract)) {
// got.abstract = m["matched"];
// }
if (auto m = got.search_text_area.matchFirst(rgx.src_filename_base)) {
got.src_filename_base = m["matched"];
got.canned_query ~= "&bfn=" ~ m["matched"];
}
}
if ("fn" in cgi.post) {
got.fn = cgi.post["fn"];
got.canned_query ~= "&fn=" ~ cgi.post["fn"];
}
if ("rt" in cgi.post) {
got.results_type = cgi.post["rt"];
got.canned_query ~= "&rt=" ~ cgi.post["rt"];
}
if ("sts" in cgi.post) {
got.stats = cgi.post["sts"];
got.canned_query ~= "&sts=" ~ cgi.post["sts"];
}
if ("ec" in cgi.post) {
got.echo = cgi.post["ec"];
got.canned_query ~= "&ec=" ~ cgi.post["ec"];
}
if ("url" in cgi.post) {
got.url = cgi.post["url"];
got.canned_query ~= "&url=" ~ cgi.post["url"];
}
if ("se" in cgi.post) {
got.searched = cgi.post["se"];
got.canned_query ~= "&se=" ~ cgi.post["se"];
}
if ("sql" in cgi.post) {
got.sql = cgi.post["sql"];
got.canned_query ~= "&sql=" ~ cgi.post["sql"];
}
if ("sml" in cgi.post) {
got.sql_match_limit = cgi.post["sml"];
got.canned_query ~= "&sml=" ~ cgi.post["sml"];
}
if ("smo" in cgi.post) {
got.sql_match_offset = "0"; // cgi.post["smo"];
got.canned_query ~= "&smo=0"; // ~ cgi.post["smo"];
}
got.canned_query = got.canned_query.strip.split(" ").join("%%20");
conf.query_string = got.canned_query;
// cgi.write("f.canned_query: " ~ got.canned_query ~ " ");
#+END_SRC
****** GET
#+NAME: cgi_sqlite_initialize_env_1
#+BEGIN_SRC d
} else if (environment.get("REQUEST_METHOD", "POST") == "GET") {
got.canned_query = environment.get("QUERY_STRING", "");
// cgi.write("f.canned_query: " ~ got.canned_query ~ " ");
got.search_text_area = "";
if ("sf" in canned_query && !(canned_query["sf"]).empty) {
got.text = canned_query["sf"].split("%%20").join(" ");
got.search_text_area ~= "text: " ~ got.text ~ "\n";
}
if ("au" in canned_query && !(canned_query["au"]).empty) {
got.author = canned_query["au"].split("%%20").join(" ");
got.search_text_area ~= "author: " ~ got.author ~ "\n";
}
if ("ti" in canned_query && !(canned_query["ti"]).empty) {
got.title = canned_query["ti"].split("%%20").join(" ");
got.search_text_area ~= "title: " ~ got.title ~ "\n";
}
if ("uid" in canned_query && !(canned_query["uid"]).empty) {
got.uid = canned_query["uid"].split("%%20").join(" ");
got.search_text_area ~= "uid: " ~ got.uid ~ "\n";
}
if ("fn" in canned_query && !(canned_query["fn"]).empty) {
got.fn = canned_query["fn"].split("%%20").join(" ");
got.search_text_area ~= "fn: " ~ got.fn ~ "\n";
}
if ("kw" in canned_query && !(canned_query["kw"]).empty) {
got.keywords = canned_query["kw"].split("%%20").join(" ");
got.search_text_area ~= "keywords: " ~ got.keywords ~ "\n";
}
if ("tr" in canned_query && !(canned_query["tr"]).empty) {
got.topic_register = canned_query["tr"].split("%%20").join(" ");
got.search_text_area ~= "topic_register: " ~ got.topic_register ~ "\n";
}
if ("su" in canned_query && !(canned_query["su"]).empty) {
got.subject = canned_query["su"].split("%%20").join(" ");
got.search_text_area ~= "subject: " ~ got.subject ~ "\n";
}
if ("de" in canned_query && !(canned_query["de"]).empty) {
got.description = canned_query["de"].split("%%20").join(" ");
got.search_text_area ~= "description: " ~ got.description ~ "\n";
}
if ("pb" in canned_query && !(canned_query["pb"]).empty) {
got.publisher = canned_query["pb"].split("%%20").join(" ");
got.search_text_area ~= "publisher: " ~ got.publisher ~ "\n";
}
if ("ed" in canned_query && !(canned_query["ed"]).empty) {
got.editor = canned_query["ed"].split("%%20").join(" ");
got.search_text_area ~= "editor: " ~ got.editor ~ "\n";
}
if ("ct" in canned_query && !(canned_query["ct"]).empty) {
got.contributor = canned_query["ct"].split("%%20").join(" ");
got.search_text_area ~= "contributor: " ~ got.contributor ~ "\n";
}
if ("dt" in canned_query && !(canned_query["dt"]).empty) {
got.date = canned_query["dt"].split("%%20").join(" ");
got.search_text_area ~= "date: " ~ got.date ~ "\n";
}
if ("rt" in canned_query && !(canned_query["rt"]).empty) {
got.results_type = canned_query["rt"].split("%%20").join(" ");
// got.search_text_area ~= "results_type: " ~ got.results_type ~ "\n";
}
if ("fmt" in canned_query && !(canned_query["fmt"]).empty) {
got.format = canned_query["fmt"].split("%%20").join(" ");
got.search_text_area ~= "format: " ~ got.format ~ "\n";
}
if ("src" in canned_query && !(canned_query["src"]).empty) {
got.source = canned_query["src"].split("%%20").join(" ");
got.search_text_area ~= "source: " ~ got.source ~ "\n";
}
if ("lng" in canned_query && !(canned_query["lng"]).empty) {
got.language = canned_query["lng"].split("%%20").join(" ");
got.search_text_area ~= "language: " ~ got.language ~ "\n";
}
if ("rl" in canned_query && !(canned_query["rl"]).empty) {
got.relation = canned_query["rl"].split("%%20").join(" ");
got.search_text_area ~= "relation: " ~ got.relation ~ "\n";
}
if ("cv" in canned_query && !(canned_query["cv"]).empty) {
got.coverage = canned_query["cv"].split("%%20").join(" ");
got.search_text_area ~= "coverage: " ~ got.coverage ~ "\n";
}
if ("rgt" in canned_query && !(canned_query["rgt"]).empty) {
got.rights = canned_query["rgt"].split("%%20").join(" ");
got.search_text_area ~= "rights: " ~ got.rights ~ "\n";
}
if ("cmt" in canned_query && !(canned_query["cmt"]).empty) {
got.comment = canned_query["cmt"].split("%%20").join(" ");
got.search_text_area ~= "comment: " ~ got.comment ~ "\n";
}
// if ("abstract" in canned_query && !(canned_query["abstract"]).empty) {
// got.abstract = canned_query["abstract"];
// }
if ("bfn" in canned_query && !(canned_query["bfn"]).empty) { // search_field
got.src_filename_base = canned_query["bfn"].split("%%20").join(" ");
got.search_text_area ~= "src_filename_base: " ~ got.src_filename_base ~ "\n";
}
if ("sml" in canned_query && !(canned_query["sml"]).empty) {
got.sql_match_limit = canned_query["sml"].split("%%20").join(" ");
// got.search_text_area ~= "sql_match_limit: " ~ got.sql_match_limit ~ "\n";
}
// cgi.write("f.search_text_area: " ~ got.search_text_area ~ " ");
}
return got;
#+END_SRC
***** tail
#+NAME: cgi_sqlite_initialize_tail
#+BEGIN_SRC d
}
auto tf = text_fields; //
#+END_SRC
**** SQL select
#+NAME: cgi_sqlite_initialize_sql_select
#+BEGIN_SRC d
struct SQL_select {
string the_body = "";
string the_range = "";
}
auto sql_select = SQL_select();
#+END_SRC
**** misc
***** canned url
#+NAME: cgi_sqlite_initialize_canned_url
#+BEGIN_SRC d
string canned_url () {
string _url = "";
if (environment.get("REQUEST_METHOD", "POST") == "POST") {
_url = conf.http_request_type ~ "://" ~ conf.http_host ~ conf.cgi_script ~ "?" ~ tf.canned_query;
} else if (environment.get("REQUEST_METHOD", "POST") == "GET") {
_url = conf.http_request_type ~ "://" ~ conf.http_host ~ conf.cgi_script ~ "?" ~ environment.get("QUERY_STRING", "");
}
return _url;
}
#+END_SRC
***** canned url regex
#+NAME: cgi_sqlite_initialize_regex_for_canned_search
#+BEGIN_SRC d
auto regex_canned_search () {
static struct RgxCS {
static track_offset = ctRegex!(`(?P[&]smo=)(?P[0-9]+)`);
static results_type = ctRegex!(`[&]rt=(?Pidx|txt)`);
static results_type_index = ctRegex!(`[&]rt=idx`);
static results_type_text = ctRegex!(`[&]rt=txt`);
static fn = ctRegex!(`[&]fn=(?P[^&]+)`);
}
return RgxCS();
}
#+END_SRC
***** previous & next actions
#+NAME: cgi_sqlite_initialize_previous_next
#+BEGIN_SRC d
string base ; // = "";
string tip ; // = "";
string search_note ; // = "";
uint sql_match_offset_count = 0;
string previous_next () {
auto rgx = regex_canned_search;
string _previous_next = "";
int _current_offset_value = 0;
string _set_offset_next = "";
string _set_offset_previous = "";
string _url = canned_url;
string _url_previous = "";
string _url_next = "";
string arrow_previous = "";
string arrow_next = "";
if (auto m = _url.matchFirst(rgx.track_offset)) {
_current_offset_value = m.captures["offset_val"].to!int;
_set_offset_next = m.captures["offset_key"] ~ ((m.captures["offset_val"]).to!int + cv.sql_match_limit.to!int).to!string;
_url_next = _url.replace(rgx.track_offset, _set_offset_next);
if (_current_offset_value < cv.sql_match_limit.to!int) {
_url_previous = "";
} else {
_url_previous = "";
_set_offset_previous = m.captures["offset_key"] ~ ((m.captures["offset_val"]).to!int - cv.sql_match_limit.to!int).to!string;
_url_previous = _url.replace(rgx.track_offset, _set_offset_previous);
}
} else {// _current_offset_value = 0;
_url_next = _url ~= "&smo=" ~ cv.sql_match_limit.to!string;
}
if (_url_previous.empty) {
arrow_previous = "";
} else {
arrow_previous =
""
~ ""
~ "<< prev"
~ " || ";
}
arrow_next =
""
~ ""
~ "next >>"
~ " ";
_previous_next = " " ~ arrow_previous ~ arrow_next;
return _previous_next;
}
#+END_SRC
***** show matched objects text | index toggle
#+NAME: cgi_sqlite_initialize_show_matched_objects
#+BEGIN_SRC d
string show_matched_objects (string fn) {
auto rgx = regex_canned_search;
string _matched_objects_text = "";
string _url = canned_url;
string _url_new = "";
string _matches_show_text = "&rt=txt";
string _matches_show_index = "&rt=idx";
string _fn = "&fn=" ~ fn;
_url_new = _url;
if (_url_new.match(rgx.results_type_index)) {
_url_new = _url_new.replace(rgx.results_type_index, _matches_show_text);
} else if (_url.match(rgx.results_type_text)) {
_url_new = _url_new.replace(rgx.results_type_text, _matches_show_index);
} else {
if (!(_url.match(rgx.results_type))) {
_url_new = _url ~ _matches_show_text;
}
}
if (!(_url_new.match(rgx.fn))) {
_url_new = _url_new ~ _fn;
}
_matched_objects_text =
""
~ ""
~ "※"
~ " ";
return _matched_objects_text;
}
#+END_SRC
** cgi
*** cgi html header
**** format
#+NAME: cgi_sqlite_header_0
#+BEGIN_SRC d
{
header = format(q"┃
#+END_SRC
**** html
#+NAME: cgi_sqlite_header_1
#+BEGIN_SRC html
%s
┃",
conf.http_host,
);
}
#+END_SRC
*** cgi html table
#+NAME: cgi_sqlite_table
#+BEGIN_SRC html
{
table = format(q"┃
┃");
}
#+END_SRC
*** cgi html form
#+NAME: cgi_sqlite_form_0
#+BEGIN_SRC d
{
string post_value(string field_name, string type="box", string set="on") {
string val = "";
switch (type) {
case "field":
val = ((field_name in cgi.post && !(cgi.post[field_name]).empty)
? cgi.post[field_name]
: (field_name in cgi.get)
? cgi.get[field_name]
: "");
val = tf.search_text_area;
break;
case "box": // generic for checkbox or radio; checkbox set == "on" radio set == "name set"
val = ((field_name in cgi.post && !(cgi.post[field_name]).empty)
? (cgi.post[field_name] == set ? "checked" : "off")
: (field_name in cgi.get)
? (cgi.get[field_name] == set ? "checked" : "off")
: "off");
break;
case "radio": // used generic bo
val = ((field_name in cgi.post && !(cgi.post[field_name]).empty)
? (cgi.post[field_name] == set ? "checked" : "off")
: (field_name in cgi.get)
? (cgi.get[field_name] == set ? "checked" : "off")
: "checked");
break;
case "checkbox": // used generic bo
val = ((field_name in cgi.post && !(cgi.post[field_name]).empty)
? (cgi.post[field_name] == set ? "checked" : "off")
: (field_name in cgi.get)
? (cgi.get[field_name] == set ? "checked" : "off")
: "checked");
break;
default:
}
return val;
}
#+END_SRC
**** canned search
#+NAME: cgi_sqlite_form_1
#+BEGIN_SRC d
string the_can(string fv) {
string show_the_can = post_value("url");
string _the_can = "";
if (show_the_can == "checked") {
tf = text_fields;
string method_get_url = conf.http_request_type ~ "://" ~ conf.http_host ~ conf.cgi_script ~ "?" ~ environment.get("QUERY_STRING", "");
string method_post_url_construct = conf.http_request_type ~ "://" ~ conf.http_host ~ conf.cgi_script ~ "?" ~ tf.canned_query;
// assert(method_get_url == environment.get("HTTP_REFERER", conf.http_request_type ~ "://" ~ conf.http_host ~ conf.cgi_script ~ "?" ~ conf.query_string));
if (conf.request_method == "POST") {
_the_can =
""
~ "POST: "
~ ""
~ method_post_url_construct
~ " "
~ " ";
} else if (conf.request_method == "GET") {
_the_can =
""
~ "GET: "
~ ""
~ method_get_url
~ " ";
}
conf.http_url = conf.http_request_type ~ "://" ~ conf.http_host ~ conf.cgi_script ~ tf.canned_query;
}
return _the_can;
}
#+END_SRC
**** provide tip
#+NAME: cgi_sqlite_form_2
#+BEGIN_SRC d
string provide_tip() {
string searched_tip = post_value("se");
string tip = "";
if (searched_tip == "checked") {
string search_field = post_value("sf", "field");
tf = text_fields;
tip = format(q"┃
database: %%s ; selected view: index
search string: %%s %%s %%s %%s %%s %%s
%%s %%s %%s %%s %%s %%s
┃",
cv.db_selected,
(tf.text.empty ? "" : "\"text: " ~ tf.text ~ " ; "),
(tf.title.empty ? "" : "\"title: " ~ tf.title ~ " ; "),
(tf.author.empty ? "" : "\"author: " ~ tf.author ~ " ; "),
(tf.date.empty ? "" : "\"date " ~ tf.date ~ " ; "),
(tf.uid.empty ? "" : "\"uid: " ~ tf.uid ~ " ; "),
(tf.fn.empty ? "" : "\"fn: " ~ tf.fn ~ " ; "),
(tf.text.empty ? "" : "text: " ~ tf.text ~ " "),
(tf.title.empty ? "" : "title: " ~ tf.title ~ " "),
(tf.author.empty ? "" : "author: " ~ tf.author ~ " "),
(tf.date.empty ? "" : "date: " ~ tf.date ~ " "),
(tf.uid.empty ? "" : "\"uid: " ~ tf.uid ~ " ; "),
(tf.fn.empty ? "" : "\"fn: " ~ tf.fn ~ " ; "),
);
}
return tip;
}
#+END_SRC
**** the form
***** form html
#+NAME: cgi_sqlite_form_3
#+BEGIN_SRC html
form = format(q"┃
┃",
#+END_SRC
***** form values
#+NAME: cgi_sqlite_form_post_0
#+BEGIN_SRC d
(post_value("ec") == "checked") ? post_value("sf", "field") : "",
provide_tip,
search_note,
the_can(post_value("sf", "field")),
cv.db_selected,
post_value("rt", "box", "idx"),
post_value("rt", "box", "txt"),
post_value("sml", "box", "1000"),
post_value("sml", "box", "2500"),
post_value("ec"),
post_value("url"),
post_value("se"),
post_value("sql"),
);
#+END_SRC
**** set value (debug)
#+NAME: cgi_sqlite_form_post_1
#+BEGIN_SRC d
{
string set_value(string field_name, string default_val) {
string val;
if (field_name in cgi.post) {
val = cgi.post[field_name];
} else if (field_name in cgi.get) {
val = cgi.get[field_name];
} else { val = default_val; }
return val;
}
bool set_bool(string field_name) {
bool val;
if (field_name in cgi.post
&& cgi.post[field_name] == "on") {
val = true;
} else if (field_name in cgi.get
&& cgi.get[field_name] == "on") {
val = true;
} else { val = false; }
return val;
}
cv.db_selected = set_value("selected_db", "%s"); // selected_db_name == db (spine.search.db or whatever)
cv.sql_match_limit = set_value("sml", "1000");
cv.sql_match_offset = set_value("smo", "0");
cv.search_text = set_value("sf", "");
cv.results_type = set_value("rt", "idx");
cv.checked_echo = set_bool("ec");
cv.checked_stats = set_bool("sts");
cv.checked_url = set_bool("url");
cv.checked_searched = set_bool("se");
cv.checked_tip = set_bool("tip");
cv.checked_sql = set_bool("sql");
tf = text_fields;
}
}
#+END_SRC
*** cgi write
#+NAME: cgi_sqlite_write
#+BEGIN_SRC d
{
cgi.write(header);
cgi.write(table);
cgi.write(form);
// cgi.write(previous_next);
{ // debug environment
// foreach (k, d; environment.toAA) {
// cgi.write(k ~ ": " ~ d ~ " ");
// }
}
{ // debug cgi info
// cgi.write("db_selected: " ~ cv.db_selected ~ " \n");
// cgi.write("search_text: " ~ cv.search_text ~ " \n");
// cgi.write("sql_match_limit: " ~ cv.sql_match_limit ~ ";\n");
// cgi.write("sql_match_offset: " ~ cv.sql_match_offset ~ ";\n");
// cgi.write("results_type: " ~ cv.results_type ~ " \n");
// cgi.write("cv.checked_echo: " ~ (cv.checked_echo ? "checked" : "off") ~ "; \n");
// cgi.write("cv.checked_stats: " ~ (cv.checked_stats ? "checked" : "off") ~ "; \n");
// cgi.write("cv.checked_url: " ~ (cv.checked_url ? "checked" : "off") ~ "; \n");
// cgi.write("cv.checked_searched: " ~ (cv.checked_searched ? "checked" : "off") ~ "; \n");
// cgi.write("cv.checked_tip: " ~ (cv.checked_tip ? "checked" : "off") ~ "; \n");
// cgi.write("cv.checked_sql: " ~ (cv.checked_sql ? "checked" : "off") ~ " \n");
}
}
#+END_SRC
** db
*** db set
#+NAME: cgi_sqlite_set_db
#+BEGIN_SRC d
auto db = Database(conf.db_path ~ cv.db_selected);
#+END_SRC
*** db sql SELECT statement
**** select where
#+NAME: cgi_sqlite_select_statement_0
#+BEGIN_SRC d
{
uint sql_match_offset_counter(T)(T cv) {
sql_match_offset_count += cv.sql_match_limit.to!uint;
return sql_match_offset_count;
}
void sql_search_query() {
string highlight_text_matched(string _txt, string search_field) {
string _mark_open = "┤";
string _mark_close = "├";
string _span_match = "";
string _span_close = " ";
string _sf_str = search_field.strip.split("%%20").join(" ").strip;
string[] _sf_arr = _sf_str.split(regex(r"\s+AND\s+|\s+OR\s+"));
auto rgx_url = regex(r"]+?>");
foreach (_sf; _sf_arr) {
auto rgx_matched_text = regex(_sf, "i");
auto rgx_marked_pair = regex(r"┤(?P" ~ _sf ~ ")├", "i");
if (auto m = _txt.matchFirst(rgx_url)) {
_txt = replaceAll!(m =>
_mark_open
~ m.captures[0]
~ _mark_close
)(_txt, rgx_matched_text);
_txt = replaceAll!(m =>
replaceAll!(u =>
u["keep"]
)(m.hit, rgx_marked_pair)
)(_txt, rgx_url);
_txt = replaceAll!(m =>
_span_match
~ m["keep"]
~ _span_close
)(_txt, rgx_marked_pair);
} else {
_txt = replaceAll!(m =>
_span_match
~ m.captures[0]
~ _span_close
)(_txt, rgx_matched_text);
}
}
return _txt;
}
string select_field_like(string db_field, string search_field) {
string where_ = "";
if (!(search_field.empty)) {
string _sf = search_field.strip.split("%%20").join(" ");
if (_sf.match(r" OR ")) {
_sf = _sf.split(" OR ").join("%%' OR " ~ db_field ~ " LIKE '%%");
}
if (_sf.match(r" AND ")) {
_sf = _sf.split(" AND ").join("%%' AND " ~ db_field ~ " LIKE '%%");
}
_sf = "( " ~ db_field ~ " LIKE\n '%%" ~ _sf ~ "%%' )";
where_ ~= format(q"┃
%%s
┃",
_sf
);
}
return where_;
}
string[] _fields;
_fields ~= select_field_like("doc_objects.clean", tf.text);
_fields ~= select_field_like("metadata_and_text.title", tf.title);
_fields ~= select_field_like("metadata_and_text.creator_author", tf.author);
_fields ~= select_field_like("metadata_and_text.uid", tf.uid);
_fields ~= select_field_like("metadata_and_text.src_filename_base", tf.fn);
_fields ~= select_field_like("metadata_and_text.src_filename_base", tf.src_filename_base);
_fields ~= select_field_like("metadata_and_text.language_document_char", tf.language);
_fields ~= select_field_like("metadata_and_text.date_published", tf.date);
_fields ~= select_field_like("metadata_and_text.classify_keywords", tf.keywords);
_fields ~= select_field_like("metadata_and_text.classify_topic_register", tf.topic_register);
string[] fields;
foreach (f; _fields) {
if (!(f.empty)) { fields ~= f; }
}
string fields_str = "";
fields_str ~= fields.join(" AND ");
#+END_SRC
**** db SELECT statement, the body
#+NAME: cgi_sqlite_select_statement_1
#+BEGIN_SRC sql
sql_select.the_body ~= format(q"┃
SELECT
metadata_and_text.uid,
metadata_and_text.title,
metadata_and_text.creator_author_last_first,
metadata_and_text.creator_author,
metadata_and_text.src_filename_base,
metadata_and_text.language_document_char,
metadata_and_text.date_published,
metadata_and_text.classify_keywords,
metadata_and_text.classify_topic_register,
doc_objects.body,
doc_objects.seg_name,
doc_objects.ocn,
metadata_and_text.uid
FROM
doc_objects,
metadata_and_text
WHERE (
%%s
)
AND
doc_objects.uid_metadata_and_text = metadata_and_text.uid
ORDER BY
metadata_and_text.creator_author_last_first,
metadata_and_text.date_published DESC,
metadata_and_text.title,
metadata_and_text.language_document_char,
metadata_and_text.src_filename_base,
doc_objects.ocn
LIMIT %%s OFFSET %%s
;┃",
fields_str,
cv.sql_match_limit,
cv.sql_match_offset,
);
#+END_SRC
**** html write selected
***** head
#+NAME: cgi_sqlite_select_statement_2
#+BEGIN_SRC d
(cv.checked_sql)
? cgi.write(previous_next
~ ""
~ sql_select.the_body.strip.split("\n ").join(" ").split("\n").join(" ")
~ " \n"
)
: "";
cgi.write(previous_next);
auto select_query_results = db.execute(sql_select.the_body).cached;
string _old_uid = "";
if (!select_query_results.empty) {
string _date_published = "0000";
string _close_para = "";
string _matched_ocn_open = "";
foreach (idx, row; select_query_results) {
if (row["uid"].as!string != _old_uid) {
_close_para = (idx == 1) ? "" : "
";
_matched_ocn_open = (idx == 1) ? "" : "";
_old_uid = row["uid"].as!string;
_date_published = (row["date_published"].as!string.match(regex(r"^([0-9]{4})")))
? row["date_published"].as!string : "0000"; // used in regex that breaks if no match
auto m = _date_published.match(regex(r"^([0-9]{4})"));
string _date = (m.hit == "0000") ? "(year?) " : "(" ~ m.hit ~ ") ";
cgi.write(
_close_para
~ "
"
~ "
\""
~ row["title"].as!string ~ "\""
~ " "
~ _date
~ "[" ~ row["language_document_char"].as!string ~ "] "
~ row["creator_author_last_first"].as!string
~ " "
~ show_matched_objects(row["src_filename_base"].as!string)
~ "
"
~ "
"
);
}
#+END_SRC
***** text found
#+NAME: cgi_sqlite_select_statement_3
#+BEGIN_SRC d
if (cv.results_type == "txt") {
if (row["ocn"].as!string != "0") {
cgi.write(
""
~ "
"
~ "
"
~ highlight_text_matched(row["body"].as!string, tf.text)
~ "
"
~ "
"
);
} else {
cgi.write(
""
~ "
"
~ "
"
~ highlight_text_matched(row["body"].as!string, tf.text)
~ "
"
~ "
"
);
}
#+END_SRC
***** ocn index
#+NAME: cgi_sqlite_select_statement_4
#+BEGIN_SRC d
} else {
if (row["ocn"].as!string != "0") {
cgi.write(
_matched_ocn_open
~ ""
~ row["ocn"].as!string
~ " , "
);
} else {
cgi.write(
_matched_ocn_open
~ ""
~ row["ocn"].as!string
~ " , "
);
}
_matched_ocn_open = "";
}
#+END_SRC
***** tail
#+NAME: cgi_sqlite_select_statement_5
#+BEGIN_SRC d
}
cgi.write( previous_next);
} else { // offset_not_beyond_limit = false;
cgi.write("select_query_results empty\n");
}
cgi.write("
≅ SiSU spine
(generated) search form
git
");
}
sql_search_query;
}
#+END_SRC
*** db close
#+NAME: cgi_sqlite_db_close
#+BEGIN_SRC d
{
db.close;
}
#+END_SRC
** tail
*** cgi tail
#+NAME: cgi_sqlite_db_tail
#+BEGIN_SRC d
{
string tail = format(q"┃
┃");
cgi.write(tail);
}
#+END_SRC
* cgi-search dub.sdl
#+NAME: cgi_dub_sdl
#+BEGIN_SRC d
name "spine_cgi_sqlite_search"
description "spine cgi sqlite search"
authors "Ralph Amissah"
copyright "Copyright © 2021, Ralph Amissah"
license "GPL-3.0+"
dependency "d2sqlite3" version="%s"
dependency "arsd-official:cgi" version="%s"
subConfiguration "arsd-official:cgi" "cgi"
targetType "executable"
targetPath "./cgi-bin"
mainSourceFile "%s"
configuration "default" {
targetType "executable"
targetName "%s"
postGenerateCommands "notify-send -t 0 'D executable ready' 'spine cgi sqlite search d'"
}
#+END_SRC
* cgi.d arsd Adam Ruppe
used for cgi
https://dlang.org/phobos/std_net_curl.html
https://dlang.org/library/std/net/curl.html
https://github.com/adamdruppe/arsd
https://github.com/adamdruppe/arsd/blob/master/cgi.d
curl https://raw.githubusercontent.com/adamdruppe/arsd/master/cgi.d -o cgi.d
wget https://raw.githubusercontent.com/adamdruppe/arsd/master/cgi.d
aria2c https://raw.githubusercontent.com/adamdruppe/arsd/master/cgi.d
* cgi-search README
#+BEGIN_SRC text :NO-tangle "../misc/util/d/cgi/search/README"
change db name to match name of db you create
cv.db_selected = "spine.search.sql.db";
~dr/bin/spine-ldc -v --sqlite-db-create --sqlite-db-filename="spine.search.db" --cgi-sqlite-search-filename="spine-search" --output=/var/www ~grotto/repo/git.repo/code/project-spine/doc-reform-markup/markup_samples/markup/pod/*
~dr/bin/spine-ldc -v --sqlite-update --sqlite-db-filename="spine.search.db" --output=/var/www ~grotto/repo/git.repo/code/project-spine/doc-reform-markup/markup_samples/markup/pod/*
cd util/d/cgi/search/src
dub --force --compiler=ldc2 && sudo cp -v cgi-bin/spine-search /usr/lib/cgi-bin/.
https://localhost/cgi-bin/spine-search?
#+END_SRC
* document header including copyright & license
#+NAME: doc_header_including_copyright_and_license
#+BEGIN_SRC txt
/+
- Name: Spine, Doc Reform [a part of]
- Description: documents, structuring, processing, publishing, search
- static content generator
- Author: Ralph Amissah
[ralph.amissah@gmail.com]
- Copyright: (C) 2015 - 2021 Ralph Amissah, All Rights
Reserved.
- License: AGPL 3 or later:
Spine (SiSU), a framework for document structuring, publishing and
search
Copyright (C) Ralph Amissah
This program is free software: you can redistribute it and/or modify it
under the terms of the GNU AFERO General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.
You should have received a copy of the GNU General Public License along with
this program. If not, see [https://www.gnu.org/licenses/].
If you have Internet connection, the latest version of the AGPL should be
available at these locations:
[https://www.fsf.org/licensing/licenses/agpl.html]
[https://www.gnu.org/licenses/agpl.html]
- Spine (by Doc Reform, related to SiSU) uses standard:
- docReform markup syntax
- standard SiSU markup syntax with modified headers and minor modifications
- docReform object numbering
- standard SiSU object citation numbering & system
- Hompages:
[https://www.doc_reform.org]
[https://www.sisudoc.org]
- Git
[https://git.sisudoc.org/projects/?p=software/spine.git;a=summary]
+/
#+END_SRC
* __END__