diff options
Diffstat (limited to 'org/doc_reform.org')
| -rw-r--r-- | org/doc_reform.org | 402 | 
1 files changed, 201 insertions, 201 deletions
| diff --git a/org/doc_reform.org b/org/doc_reform.org index 77b8b24..e98cdc5 100644 --- a/org/doc_reform.org +++ b/org/doc_reform.org @@ -24,7 +24,7 @@ struct Version {    int minor;    int patch;  } -enum ver = Version(0, 1, 0); +enum ver = Version(0, 2, 0);  #+END_SRC  ** compilation restrictions (supported compilers) @@ -256,7 +256,7 @@ bool[string] opts = [    "parallelise"        : true,    "parallelise-subprocesses" : false,    "quiet"              : false, -  "sisupod"            : false, +  "pod"                : false,    "source"             : false,    "sqlite-discrete"    : false,    "sqlite-db-create"   : false, @@ -301,7 +301,7 @@ auto helpInfo = getopt(args,    "parallelise",        "--parallelise parallelisation",                                            &opts["parallelise"],    "parallelise-subprocesses", "--parallelise-subprocesses nested parallelisation",                  &opts["parallelise-subprocesses"],    "quiet",              "--quiet output to terminal",                                               &opts["quiet"], -  "sisupod",            "--sisupod sisupod source content bundled",                                 &opts["sisupod"], +  "pod",                "--pod doc reform pod source content bundled",                              &opts["pod"],    "source",             "--source markup source text content",                                      &opts["source"],    "sqlite-discrete",    "--sqlite process discrete sqlite output",                                  &opts["sqlite-discrete"],    "sqlite-db-create",   "--sqlite-db-create create db, create tables",                              &opts["sqlite-db-create"], @@ -339,7 +339,7 @@ if (helpInfo.helpWanted) {  #+NAME: doc_reform_args  #+BEGIN_SRC d -enum outTask { sisupod, source, sqlite, sqlite_multi, epub, html_scroll, html_seg, html_stuff } +enum outTask { pod, source, sqlite, sqlite_multi, epub, html_scroll, html_seg, html_stuff }  struct OptActions {    auto assertions() {      return opts["assertions"]; @@ -403,8 +403,8 @@ struct OptActions {    auto quiet() {      return opts["quiet"];    } -  auto sisupod() { -    return opts["sisupod"]; +  auto pod() { +    return opts["pod"];    }    auto source() {      return opts["source"]; @@ -518,8 +518,8 @@ struct OptActions {    }    auto output_task_scheduler() {      int[] schedule; -    if (sisupod) { -      schedule ~= outTask.sisupod; +    if (pod) { +      schedule ~= outTask.pod;      }      if (source) {        schedule ~= outTask.source; @@ -548,7 +548,7 @@ struct OptActions {        || epub        || html        || manifest -      || sisupod +      || pod        || source        || sqlite_discrete        || sqlite_delete @@ -1171,21 +1171,21 @@ dev notes  ** doc_reform glossary / terms -|------+-------------------------------------| -| doc_reform  | sisu document parser                | -|------+-------------------------------------| -| dmso | document markup, structure, objects | -|------+-------------------------------------| -| meta | meta document, document abstraction | -| mda  | meta, meta document abstraction     | -| adr  | abstract document representation    | -| dar  | document abstract representation    | -| (da) | (document abstraction)              | -|      | (code representation of document)   | -|------+-------------------------------------| -| ao   | abstract objects                    | -|      | (code representation of objects)    | -|------+-------------------------------------| +|------------+-------------------------------------| +| doc_reform | sisu document parser                | +|------------+-------------------------------------| +| dmso       | document markup, structure, objects | +|------------+-------------------------------------| +| meta       | meta document, document abstraction | +| mda        | meta, meta document abstraction     | +| adr        | abstract document representation    | +| dar        | document abstract representation    | +| (da)       | (document abstraction)              | +|            | (code representation of document)   | +|------------+-------------------------------------| +| ao         | abstract objects                    | +|            | (code representation of objects)    | +|------------+-------------------------------------|  consider  |-------+----------------------------------------------| @@ -1386,180 +1386,180 @@ provide the result as a single set of make instructions for each document parsed  *** config & metadata (from instruction sources) -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     | 1. document make file    | 2. config file             | 3. document header     | 4. command line instruction | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -| comment, fixed:     | per dir (sisupod)        | per dir                    | per document (sisupod) | per command instruction     | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     | sdl_root_config_document | sdl_root_config_local_site |                        |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -| local site specific |                          | *                          |                        | *?                          | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          | webserv                    |                        |                             | -|                     |                          | - url_root                 |                        |                             | -|                     |                          | - path                     |                        |                             | -|                     |                          | - images                   |                        |                             | -|                     |                          | - cgi                      |                        |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          | webserv_cgi                |                        |                             | -|                     |                          | - host                     |                        |                             | -|                     |                          | - base_path                |                        |                             | -|                     |                          | - port                     |                        |                             | -|                     |                          | - user                     |                        |                             | -|                     |                          | - file_links               |                        |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          | processing                 |                        |                             | -|                     |                          | - path                     |                        |                             | -|                     |                          | - dir                      |                        |                             | -|                     |                          | - concord_max              |                        |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          | flag (configure)           |                        | (call)                      | -|                     |                          | - act0                     |                        | act0                        | -|                     |                          | - act1                     |                        | act1                        | -|                     |                          | - act2                     |                        | act2                        | -|                     |                          | - act3                     |                        | act3                        | -|                     |                          | - act4                     |                        | act4                        | -|                     |                          | - act5                     |                        | act5                        | -|                     |                          | - act6                     |                        | act6                        | -|                     |                          | - act7                     |                        | act7                        | -|                     |                          | - act8                     |                        | act8                        | -|                     |                          | - act9                     |                        | act9                        | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          | default                    |                        |                             | -|                     |                          | - papersize                |                        |                             | -|                     |                          | - text_wrap                |                        |                             | -|                     |                          | - emphasis                 |                        |                             | -|                     |                          | - language                 |                        |                             | -|                     |                          | - digest                   |                        |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          | permission                 |                        |                             | -|                     |                          | - share_source             |                        |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          | program_select             |                        |                             | -|                     |                          | - editor                   |                        |                             | -|                     |                          | - epub_viewer              |                        |                             | -|                     |                          | - html_viewer              |                        |                             | -|                     |                          | - odf_viewer               |                        |                             | -|                     |                          | - pdf_viewer               |                        |                             | -|                     |                          | - xml_viewer               |                        |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          | search                     |                        |                             | -|                     |                          | - flag                     |                        |                             | -|                     |                          | - action                   |                        |                             | -|                     |                          | - db                       |                        |                             | -|                     |                          | - title                    |                        |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -| make instruction    | **                       | omit or override share?    | **                     | *?                          | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     | make                     | make                       | make                   |                             | -|                     | - bold                   | - bold                     | - bold                 |                             | -|                     | - breaks                 | - breaks                   | - breaks               |                             | -|                     | - cover_image            | - cover_image              | - cover_image          |                             | -|                     | - css                    | - css                      | - css                  |                             | -|                     | - emphasis               | - emphasis                 | - emphasis             |                             | -|                     | - footer                 | - footer                   | - footer               |                             | -|                     | - headings               | - headings                 | - headings             |                             | -|                     | - home_button_image      | - home_button_image        | - home_button_image    |                             | -|                     | - home_button_text       | - home_button_text         | - home_button_text     |                             | -|                     | - italics                | - italics                  | - italics              |                             | -|                     | - num_top                | - num_top                  | - num_top              |                             | -|                     | - auto_num_depth         | - auto_num_depth           | - auto_num_depth       |                             | -|                     | - substitute             | - substitute               | - substitute           |                             | -|                     | - texpdf_font            | - texpdf_font              | - texpdf_font          |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -| actions             |                          |                            |                        | *                           | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            |                        | assertions                  | -|                     |                          |                            |                        | concordance                 | -|                     |                          |                            |                        | debug                       | -|                     |                          |                            |                        | digest                      | -|                     |                          |                            |                        | docbook                     | -|                     |                          |                            |                        | epub                        | -|                     |                          |                            |                        | html                        | -|                     |                          |                            |                        | html-seg                    | -|                     |                          |                            |                        | html-scroll                 | -|                     |                          |                            |                        | manifest                    | -|                     |                          |                            |                        | ocn                         | -|                     |                          |                            |                        | odt                         | -|                     |                          |                            |                        | pdf                         | -|                     |                          |                            |                        | postgresql                  | -|                     |                          |                            |                        | qrcode                      | -|                     |                          |                            |                        | sisupod                     | -|                     |                          |                            |                        | source                      | -|                     |                          |                            |                        | sqlite                      | -|                     |                          |                            |                        | sqlite-db-create            | -|                     |                          |                            |                        | sqlite-db-drop              | -|                     |                          |                            |                        | text                        | -|                     |                          |                            |                        | verbose                     | -|                     |                          |                            |                        | xhtml                       | -|                     |                          |                            |                        | xml-dom                     | -|                     |                          |                            |                        | xml-sax                     | -|                     |                          |                            |                        | section_toc                 | -|                     |                          |                            |                        | section_body                | -|                     |                          |                            |                        | section_endnotes            | -|                     |                          |                            |                        | section_glossary            | -|                     |                          |                            |                        | section_biblio              | -|                     |                          |                            |                        | section_bookindex           | -|                     |                          |                            |                        | section_blurb               | -|                     |                          |                            |                        | backmatter                  | -|                     |                          |                            |                        | skip-output                 | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -| metadata            |                          |                            | *                      |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | classify               |                             | -|                     |                          |                            | - dewey                |                             | -|                     |                          |                            | - keywords             |                             | -|                     |                          |                            | - loc                  |                             | -|                     |                          |                            | - subject              |                             | -|                     |                          |                            | - topic_register       |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | creator                |                             | -|                     |                          |                            | - author               |                             | -|                     |                          |                            | - author_email         |                             | -|                     |                          |                            | - illustrator          |                             | -|                     |                          |                            | - translator           |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | date                   |                             | -|                     |                          |                            | - added_to_site        |                             | -|                     |                          |                            | - available            |                             | -|                     |                          |                            | - created              |                             | -|                     |                          |                            | - issued               |                             | -|                     |                          |                            | - modified             |                             | -|                     |                          |                            | - published            |                             | -|                     |                          |                            | - valid                |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | identifier             |                             | -|                     |                          |                            | - isbn                 |                             | -|                     |                          |                            | - oclc                 |                             | -|                     |                          |                            | - pg                   |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | links                  |                             | -|                     |                          |                            | - link                 |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | notes                  |                             | -|                     |                          |                            | - abstract             |                             | -|                     |                          |                            | - description          |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | original               |                             | -|                     |                          |                            | - language             |                             | -|                     |                          |                            | - source               |                             | -|                     |                          |                            | - title                |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | publisher              |                             | -|                     |                          |                            | - name                 |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | rights                 |                             | -|                     |                          |                            | - copyright            |                             | -|                     |                          |                            | - cover                |                             | -|                     |                          |                            | - illustrations        |                             | -|                     |                          |                            | - license              |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| -|                     |                          |                            | title                  |                             | -|                     |                          |                            | - edition              |                             | -|                     |                          |                            | - full                 |                             | -|                     |                          |                            | - language             |                             | -|                     |                          |                            | - main                 |                             | -|                     |                          |                            | - note                 |                             | -|                     |                          |                            | - sub                  |                             | -|                     |                          |                            | - subtitle             |                             | -|---------------------+--------------------------+----------------------------+------------------------+-----------------------------| +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     | 1. document make file    | 2. config file             | 3. document header  | 4. command line instruction | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +| comment, fixed:     | per dir (pod)            | per dir                    | per document (pod)  | per command instruction     | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     | sdl_root_config_document | sdl_root_config_local_site |                     |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +| local site specific |                          | *                          |                     | *?                          | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          | webserv                    |                     |                             | +|                     |                          | - url_root                 |                     |                             | +|                     |                          | - path                     |                     |                             | +|                     |                          | - images                   |                     |                             | +|                     |                          | - cgi                      |                     |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          | webserv_cgi                |                     |                             | +|                     |                          | - host                     |                     |                             | +|                     |                          | - base_path                |                     |                             | +|                     |                          | - port                     |                     |                             | +|                     |                          | - user                     |                     |                             | +|                     |                          | - file_links               |                     |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          | processing                 |                     |                             | +|                     |                          | - path                     |                     |                             | +|                     |                          | - dir                      |                     |                             | +|                     |                          | - concord_max              |                     |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          | flag (configure)           |                     | (call)                      | +|                     |                          | - act0                     |                     | act0                        | +|                     |                          | - act1                     |                     | act1                        | +|                     |                          | - act2                     |                     | act2                        | +|                     |                          | - act3                     |                     | act3                        | +|                     |                          | - act4                     |                     | act4                        | +|                     |                          | - act5                     |                     | act5                        | +|                     |                          | - act6                     |                     | act6                        | +|                     |                          | - act7                     |                     | act7                        | +|                     |                          | - act8                     |                     | act8                        | +|                     |                          | - act9                     |                     | act9                        | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          | default                    |                     |                             | +|                     |                          | - papersize                |                     |                             | +|                     |                          | - text_wrap                |                     |                             | +|                     |                          | - emphasis                 |                     |                             | +|                     |                          | - language                 |                     |                             | +|                     |                          | - digest                   |                     |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          | permission                 |                     |                             | +|                     |                          | - share_source             |                     |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          | program_select             |                     |                             | +|                     |                          | - editor                   |                     |                             | +|                     |                          | - epub_viewer              |                     |                             | +|                     |                          | - html_viewer              |                     |                             | +|                     |                          | - odf_viewer               |                     |                             | +|                     |                          | - pdf_viewer               |                     |                             | +|                     |                          | - xml_viewer               |                     |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          | search                     |                     |                             | +|                     |                          | - flag                     |                     |                             | +|                     |                          | - action                   |                     |                             | +|                     |                          | - db                       |                     |                             | +|                     |                          | - title                    |                     |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +| make instruction    | **                       | omit or override share?    | **                  | *?                          | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     | make                     | make                       | make                |                             | +|                     | - bold                   | - bold                     | - bold              |                             | +|                     | - breaks                 | - breaks                   | - breaks            |                             | +|                     | - cover_image            | - cover_image              | - cover_image       |                             | +|                     | - css                    | - css                      | - css               |                             | +|                     | - emphasis               | - emphasis                 | - emphasis          |                             | +|                     | - footer                 | - footer                   | - footer            |                             | +|                     | - headings               | - headings                 | - headings          |                             | +|                     | - home_button_image      | - home_button_image        | - home_button_image |                             | +|                     | - home_button_text       | - home_button_text         | - home_button_text  |                             | +|                     | - italics                | - italics                  | - italics           |                             | +|                     | - num_top                | - num_top                  | - num_top           |                             | +|                     | - auto_num_depth         | - auto_num_depth           | - auto_num_depth    |                             | +|                     | - substitute             | - substitute               | - substitute        |                             | +|                     | - texpdf_font            | - texpdf_font              | - texpdf_font       |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +| actions             |                          |                            |                     | *                           | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            |                     | assertions                  | +|                     |                          |                            |                     | concordance                 | +|                     |                          |                            |                     | debug                       | +|                     |                          |                            |                     | digest                      | +|                     |                          |                            |                     | docbook                     | +|                     |                          |                            |                     | epub                        | +|                     |                          |                            |                     | html                        | +|                     |                          |                            |                     | html-seg                    | +|                     |                          |                            |                     | html-scroll                 | +|                     |                          |                            |                     | manifest                    | +|                     |                          |                            |                     | ocn                         | +|                     |                          |                            |                     | odt                         | +|                     |                          |                            |                     | pdf                         | +|                     |                          |                            |                     | postgresql                  | +|                     |                          |                            |                     | qrcode                      | +|                     |                          |                            |                     | pod                         | +|                     |                          |                            |                     | source                      | +|                     |                          |                            |                     | sqlite                      | +|                     |                          |                            |                     | sqlite-db-create            | +|                     |                          |                            |                     | sqlite-db-drop              | +|                     |                          |                            |                     | text                        | +|                     |                          |                            |                     | verbose                     | +|                     |                          |                            |                     | xhtml                       | +|                     |                          |                            |                     | xml-dom                     | +|                     |                          |                            |                     | xml-sax                     | +|                     |                          |                            |                     | section_toc                 | +|                     |                          |                            |                     | section_body                | +|                     |                          |                            |                     | section_endnotes            | +|                     |                          |                            |                     | section_glossary            | +|                     |                          |                            |                     | section_biblio              | +|                     |                          |                            |                     | section_bookindex           | +|                     |                          |                            |                     | section_blurb               | +|                     |                          |                            |                     | backmatter                  | +|                     |                          |                            |                     | skip-output                 | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +| metadata            |                          |                            | *                   |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | classify            |                             | +|                     |                          |                            | - dewey             |                             | +|                     |                          |                            | - keywords          |                             | +|                     |                          |                            | - loc               |                             | +|                     |                          |                            | - subject           |                             | +|                     |                          |                            | - topic_register    |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | creator             |                             | +|                     |                          |                            | - author            |                             | +|                     |                          |                            | - author_email      |                             | +|                     |                          |                            | - illustrator       |                             | +|                     |                          |                            | - translator        |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | date                |                             | +|                     |                          |                            | - added_to_site     |                             | +|                     |                          |                            | - available         |                             | +|                     |                          |                            | - created           |                             | +|                     |                          |                            | - issued            |                             | +|                     |                          |                            | - modified          |                             | +|                     |                          |                            | - published         |                             | +|                     |                          |                            | - valid             |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | identifier          |                             | +|                     |                          |                            | - isbn              |                             | +|                     |                          |                            | - oclc              |                             | +|                     |                          |                            | - pg                |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | links               |                             | +|                     |                          |                            | - link              |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | notes               |                             | +|                     |                          |                            | - abstract          |                             | +|                     |                          |                            | - description       |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | original            |                             | +|                     |                          |                            | - language          |                             | +|                     |                          |                            | - source            |                             | +|                     |                          |                            | - title             |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | publisher           |                             | +|                     |                          |                            | - name              |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | rights              |                             | +|                     |                          |                            | - copyright         |                             | +|                     |                          |                            | - cover             |                             | +|                     |                          |                            | - illustrations     |                             | +|                     |                          |                            | - license           |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| +|                     |                          |                            | title               |                             | +|                     |                          |                            | - edition           |                             | +|                     |                          |                            | - full              |                             | +|                     |                          |                            | - language          |                             | +|                     |                          |                            | - main              |                             | +|                     |                          |                            | - note              |                             | +|                     |                          |                            | - sub               |                             | +|                     |                          |                            | - subtitle          |                             | +|---------------------+--------------------------+----------------------------+---------------------+-----------------------------| | 
