data/samples/by/ directory, alternative output directory structures (softlinks)sisu-markup-samples_4.2.0

* softlinks to data/samples/current
* data/samples/by/samples_by_filename
* data/samples/by/samples_by_filetype
* data/samples/by/samples_by_language

87 files changed, 1492 insertions, 0 deletions

diff --git a/data/samples/by/README b/data/samples/by/README
new file mode 100644
index 0000000..b71afe8
--- /dev/null
+++ b/data/samples/by/README
@@ -0,0 +1,10 @@
+This directory contains subdirectories that include softlinks to "current"
+samples, configured to produce differently organized directory output
+structures.
+
+* samples_by_filename
+* samples_by_filetype
+* samples_by_language
+
+Running sisu against the content in each directory results in different output
+structures.
diff --git a/data/samples/by/samples_by_filename/_sisu/image b/data/samples/by/samples_by_filename/_sisu/image
new file mode 120000
index 0000000..7cf3516
--- /dev/null
+++ b/data/samples/by/samples_by_filename/_sisu/image
@@ -0,0 +1 @@
+../../../../image
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/_sisu/rc/sisurc.yml b/data/samples/by/samples_by_filename/_sisu/rc/sisurc.yml
new file mode 120000
index 0000000..e5f2f40
--- /dev/null
+++ b/data/samples/by/samples_by_filename/_sisu/rc/sisurc.yml
@@ -0,0 +1 @@
+sisurc_fn_search.www.yml
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/_sisu/rc/sisurc_fn.www.yml b/data/samples/by/samples_by_filename/_sisu/rc/sisurc_fn.www.yml
new file mode 100644
index 0000000..7a0939e
--- /dev/null
+++ b/data/samples/by/samples_by_filename/_sisu/rc/sisurc_fn.www.yml
@@ -0,0 +1,118 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+# url_root:     'http://www.sisudoc.org' #without directory stub (name of subdirectory containing markup)
+  path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+  file_links:    www.sisudoc.org
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+#remote:
+# user:         'ralph'
+# host:         'www.???.org'
+# host:         '192.168.1.108'
+# path:         '/srv/sisudoc/www'
+# path:         '/srv/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+output_dir_structure_by: filename
+#output_dir_structure_by: filetype
+#output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_filename/_sisu/rc/sisurc_fn_search.srv.yml b/data/samples/by/samples_by_filename/_sisu/rc/sisurc_fn_search.srv.yml
new file mode 100644
index 0000000..cf88ee3
--- /dev/null
+++ b/data/samples/by/samples_by_filename/_sisu/rc/sisurc_fn_search.srv.yml
@@ -0,0 +1,133 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+# url_root:     'http://192.168.1.108' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+  url_root:     'http://www.sisudoc.org' #without dir stub, e.g. this dir would map to http://www.sisudoc.org/samples
+  path:         '/srv/www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+# path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+# file_links:    192.168.1.108
+  file_links:    www.sisudoc.org
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+remote:
+  user:         'ralph'
+  host:         'www.sisudoc.org'
+  path:         '/srv/www'
+# host:         '192.168.1.108'
+# host:         '88.198.193.70'
+# path:         '/srv/sisudoc/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+output_dir_structure_by: filename
+#output_dir_structure_by: filetype
+#output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+search:
+  sisu:
+    flag:            true
+    action:          http://www.sisudoc.org/cgi-bin/sisu_samples_fn.cgi
+    db:              markup_samples.sisu_fn
+#   action:          http://www.sisudoc.org/cgi-bin/sisu_pgsql.cgi
+#   action:          http://search.sisudoc.org
+#   action:          http://localhost:8081/cgi-bin/sisu_sqlite.cgi
+#   action:          http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+#   db:              sisu
+    title:           'SiSU search form (sample)'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_filename/_sisu/rc/sisurc_fn_search.www.yml b/data/samples/by/samples_by_filename/_sisu/rc/sisurc_fn_search.www.yml
new file mode 100644
index 0000000..30c317b
--- /dev/null
+++ b/data/samples/by/samples_by_filename/_sisu/rc/sisurc_fn_search.www.yml
@@ -0,0 +1,131 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+# url_root:     'http://192.168.1.108' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+  url_root:     'http://www.sisudoc.org' #without dir stub, e.g. this dir would map to http://www.sisudoc.org/samples
+  path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+# file_links:    192.168.1.108
+  file_links:    www.sisudoc.org
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+remote:
+  user:         'ralph'
+  host:         'www.sisudoc.org'
+  path:         '/srv/www'
+# host:         '192.168.1.108'
+# host:         '88.198.193.70'
+# path:         '/srv/sisudoc/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+output_dir_structure_by: filename
+#output_dir_structure_by: filetype
+#output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+search:
+  sisu:
+    flag:            true
+    action:          http://www.sisudoc.org/cgi-bin/sisu_fn_pgsql.cgi
+    db:              markup_samples.sisu_fn
+#   action:          http://search.sisudoc.org
+#   action:          http://localhost:8081/cgi-bin/sisu_sqlite.cgi
+#   action:          http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+#   db:              sisu
+    title:           'SiSU search form (sample)'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_filename/_sisu/sisu_document_make b/data/samples/by/samples_by_filename/_sisu/sisu_document_make
new file mode 100644
index 0000000..85e583e
--- /dev/null
+++ b/data/samples/by/samples_by_filename/_sisu/sisu_document_make
@@ -0,0 +1,9 @@
+@make:
+ :breaks: break=1
+ :home_button_text: {SiSU}http://sisudoc.org; {sources / git}http://sources.sisudoc.org/
+% :footer: {SiSU}http://sisudoc.org; {sources / git}http://sources.sisudoc.org/
+% :home_button_image: {sisu.png }http://sisudoc.org
+
+@links:+
+ {SiSU}http://sisudoc.org
+ {sources / git}http://sources.sisudoc.org/
diff --git a/data/samples/by/samples_by_filename/_sisu/sisurc.yml b/data/samples/by/samples_by_filename/_sisu/sisurc.yml
new file mode 120000
index 0000000..0ae57a1
--- /dev/null
+++ b/data/samples/by/samples_by_filename/_sisu/sisurc.yml
@@ -0,0 +1 @@
+./rc/sisurc_fn_search.www.yml
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/accelerando.charles_stross.sst b/data/samples/by/samples_by_filename/accelerando.charles_stross.sst
new file mode 120000
index 0000000..8d514e0
--- /dev/null
+++ b/data/samples/by/samples_by_filename/accelerando.charles_stross.sst
@@ -0,0 +1 @@
+../../current/en/accelerando.charles_stross.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/alices_adventures_in_wonderland.lewis_carroll.sst b/data/samples/by/samples_by_filename/alices_adventures_in_wonderland.lewis_carroll.sst
new file mode 120000
index 0000000..393c837
--- /dev/null
+++ b/data/samples/by/samples_by_filename/alices_adventures_in_wonderland.lewis_carroll.sst
@@ -0,0 +1 @@
+../../current/en/alices_adventures_in_wonderland.lewis_carroll.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/autonomy_markup0.sst b/data/samples/by/samples_by_filename/autonomy_markup0.sst
new file mode 120000
index 0000000..7386052
--- /dev/null
+++ b/data/samples/by/samples_by_filename/autonomy_markup0.sst
@@ -0,0 +1 @@
+../../current/en/autonomy_markup0.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/content.cory_doctorow.sst b/data/samples/by/samples_by_filename/content.cory_doctorow.sst
new file mode 120000
index 0000000..ccc4037
--- /dev/null
+++ b/data/samples/by/samples_by_filename/content.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/content.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/democratizing_innovation.eric_von_hippel.sst b/data/samples/by/samples_by_filename/democratizing_innovation.eric_von_hippel.sst
new file mode 120000
index 0000000..078bb69
--- /dev/null
+++ b/data/samples/by/samples_by_filename/democratizing_innovation.eric_von_hippel.sst
@@ -0,0 +1 @@
+../../current/en/democratizing_innovation.eric_von_hippel.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/down_and_out_in_the_magic_kingdom.cory_doctorow.sst b/data/samples/by/samples_by_filename/down_and_out_in_the_magic_kingdom.cory_doctorow.sst
new file mode 120000
index 0000000..5fd9354
--- /dev/null
+++ b/data/samples/by/samples_by_filename/down_and_out_in_the_magic_kingdom.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/down_and_out_in_the_magic_kingdom.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/for_the_win.cory_doctorow.sst b/data/samples/by/samples_by_filename/for_the_win.cory_doctorow.sst
new file mode 120000
index 0000000..3a78b95
--- /dev/null
+++ b/data/samples/by/samples_by_filename/for_the_win.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/for_the_win.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst b/data/samples/by/samples_by_filename/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst
new file mode 120000
index 0000000..29c8cd9
--- /dev/null
+++ b/data/samples/by/samples_by_filename/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst
@@ -0,0 +1 @@
+../../current/en/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/free_culture.lawrence_lessig.sst b/data/samples/by/samples_by_filename/free_culture.lawrence_lessig.sst
new file mode 120000
index 0000000..30ab1b4
--- /dev/null
+++ b/data/samples/by/samples_by_filename/free_culture.lawrence_lessig.sst
@@ -0,0 +1 @@
+../../current/en/free_culture.lawrence_lessig.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/free_for_all.peter_wayner.sst b/data/samples/by/samples_by_filename/free_for_all.peter_wayner.sst
new file mode 120000
index 0000000..c58fa1f
--- /dev/null
+++ b/data/samples/by/samples_by_filename/free_for_all.peter_wayner.sst
@@ -0,0 +1 @@
+../../current/en/free_for_all.peter_wayner.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/gpl2.fsf.sst b/data/samples/by/samples_by_filename/gpl2.fsf.sst
new file mode 120000
index 0000000..637c46b
--- /dev/null
+++ b/data/samples/by/samples_by_filename/gpl2.fsf.sst
@@ -0,0 +1 @@
+../../current/en/gpl2.fsf.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/gpl3.fsf.sst b/data/samples/by/samples_by_filename/gpl3.fsf.sst
new file mode 120000
index 0000000..4b485a5
--- /dev/null
+++ b/data/samples/by/samples_by_filename/gpl3.fsf.sst
@@ -0,0 +1 @@
+../../current/en/gpl3.fsf.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/gullivers_travels.jonathan_swift.sst b/data/samples/by/samples_by_filename/gullivers_travels.jonathan_swift.sst
new file mode 120000
index 0000000..0f836ef
--- /dev/null
+++ b/data/samples/by/samples_by_filename/gullivers_travels.jonathan_swift.sst
@@ -0,0 +1 @@
+../../current/en/gullivers_travels.jonathan_swift.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/little_brother.cory_doctorow.sst b/data/samples/by/samples_by_filename/little_brother.cory_doctorow.sst
new file mode 120000
index 0000000..4bb4420
--- /dev/null
+++ b/data/samples/by/samples_by_filename/little_brother.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/little_brother.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/the_cathedral_and_the_bazaar.eric_s_raymond.sst b/data/samples/by/samples_by_filename/the_cathedral_and_the_bazaar.eric_s_raymond.sst
new file mode 120000
index 0000000..6100203
--- /dev/null
+++ b/data/samples/by/samples_by_filename/the_cathedral_and_the_bazaar.eric_s_raymond.sst
@@ -0,0 +1 @@
+../../current/en/the_cathedral_and_the_bazaar.eric_s_raymond.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/the_public_domain.james_boyle.sst b/data/samples/by/samples_by_filename/the_public_domain.james_boyle.sst
new file mode 120000
index 0000000..2a1e101
--- /dev/null
+++ b/data/samples/by/samples_by_filename/the_public_domain.james_boyle.sst
@@ -0,0 +1 @@
+../../current/en/the_public_domain.james_boyle.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/the_wealth_of_networks.yochai_benkler.sst b/data/samples/by/samples_by_filename/the_wealth_of_networks.yochai_benkler.sst
new file mode 120000
index 0000000..4079f42
--- /dev/null
+++ b/data/samples/by/samples_by_filename/the_wealth_of_networks.yochai_benkler.sst
@@ -0,0 +1 @@
+../../current/en/the_wealth_of_networks.yochai_benkler.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/through_the_looking_glass.lewis_carroll.sst b/data/samples/by/samples_by_filename/through_the_looking_glass.lewis_carroll.sst
new file mode 120000
index 0000000..5d35f2e
--- /dev/null
+++ b/data/samples/by/samples_by_filename/through_the_looking_glass.lewis_carroll.sst
@@ -0,0 +1 @@
+../../current/en/through_the_looking_glass.lewis_carroll.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/two_bits.christopher_kelty.sst b/data/samples/by/samples_by_filename/two_bits.christopher_kelty.sst
new file mode 120000
index 0000000..afbcd99
--- /dev/null
+++ b/data/samples/by/samples_by_filename/two_bits.christopher_kelty.sst
@@ -0,0 +1 @@
+../../current/en/two_bits.christopher_kelty.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/un_contracts_international_sale_of_goods_convention_1980.sst b/data/samples/by/samples_by_filename/un_contracts_international_sale_of_goods_convention_1980.sst
new file mode 120000
index 0000000..429f876
--- /dev/null
+++ b/data/samples/by/samples_by_filename/un_contracts_international_sale_of_goods_convention_1980.sst
@@ -0,0 +1 @@
+../../current/en/un_contracts_international_sale_of_goods_convention_1980.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filename/viral_spiral.david_bollier.sst b/data/samples/by/samples_by_filename/viral_spiral.david_bollier.sst
new file mode 120000
index 0000000..cfcbb9e
--- /dev/null
+++ b/data/samples/by/samples_by_filename/viral_spiral.david_bollier.sst
@@ -0,0 +1 @@
+../../current/en/viral_spiral.david_bollier.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/_sisu/image b/data/samples/by/samples_by_filetype/_sisu/image
new file mode 120000
index 0000000..7cf3516
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/_sisu/image
@@ -0,0 +1 @@
+../../../../image
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/_sisu/rc/sisurc.yml b/data/samples/by/samples_by_filetype/_sisu/rc/sisurc.yml
new file mode 120000
index 0000000..b50ca7c
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/_sisu/rc/sisurc.yml
@@ -0,0 +1 @@
+sisurc_ft_search.www.yml
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/_sisu/rc/sisurc_ft.www.yml b/data/samples/by/samples_by_filetype/_sisu/rc/sisurc_ft.www.yml
new file mode 100644
index 0000000..4f71fe5
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/_sisu/rc/sisurc_ft.www.yml
@@ -0,0 +1,118 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+# url_root:     'http://www.sisudoc.org' #without directory stub (name of subdirectory containing markup)
+  path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+  file_links:    www.sisudoc.org
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+#remote:
+# user:         'ralph'
+# host:         'www.???.org'
+# host:         '192.168.1.108'
+# path:         '/srv/sisudoc/www'
+# path:         '/srv/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+#output_dir_structure_by: filename
+output_dir_structure_by: filetype
+#output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_filetype/_sisu/rc/sisurc_ft_search.srv.yml b/data/samples/by/samples_by_filetype/_sisu/rc/sisurc_ft_search.srv.yml
new file mode 100644
index 0000000..54566db
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/_sisu/rc/sisurc_ft_search.srv.yml
@@ -0,0 +1,133 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+# url_root:     'http://192.168.1.108' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+  url_root:     'http://www.sisudoc.org' #without dir stub, e.g. this dir would map to http://www.sisudoc.org/samples
+  path:         '/srv/www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+# path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+# file_links:    192.168.1.108
+  file_links:    www.sisudoc.org
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+remote:
+  user:         'ralph'
+  host:         'www.sisudoc.org'
+  path:         '/srv/www'
+# host:         '192.168.1.108'
+# host:         '88.198.193.70'
+# path:         '/srv/sisudoc/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+#output_dir_structure_by: filename
+output_dir_structure_by: filetype
+#output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+search:
+  sisu:
+    flag:            true
+    action:          http://www.sisudoc.org/cgi-bin/sisu_samples_ft.cgi
+    db:              markup_samples.sisu_ft
+#   action:          http://www.sisudoc.org/cgi-bin/sisu_pgsql.cgi
+#   action:          http://search.sisudoc.org
+#   action:          http://localhost:8081/cgi-bin/sisu_sqlite.cgi
+#   action:          http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+#   db:              sisu
+    title:           'SiSU search form (sample)'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_filetype/_sisu/rc/sisurc_ft_search.www.yml b/data/samples/by/samples_by_filetype/_sisu/rc/sisurc_ft_search.www.yml
new file mode 100644
index 0000000..69520f3
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/_sisu/rc/sisurc_ft_search.www.yml
@@ -0,0 +1,131 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+# url_root:     'http://192.168.1.108' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+  url_root:     'http://www.sisudoc.org' #without dir stub, e.g. this dir would map to http://www.sisudoc.org/samples
+  path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+# file_links:    192.168.1.108
+  file_links:    www.sisudoc.org
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+remote:
+  user:         'ralph'
+  host:         'www.sisudoc.org'
+  path:         '/srv/www'
+# host:         '192.168.1.108'
+# host:         '88.198.193.70'
+# path:         '/srv/sisudoc/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+#output_dir_structure_by: filename
+output_dir_structure_by: filetype
+#output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+search:
+  sisu:
+    flag:            true
+    action:          http://www.sisudoc.org/cgi-bin/sisu_ft_pgsql.cgi
+    db:              markup_samples.sisu_ft
+#   action:          http://search.sisudoc.org
+#   action:          http://localhost:8081/cgi-bin/sisu_sqlite.cgi
+#   action:          http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+#   db:              sisu
+    title:           'SiSU search form (sample)'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_filetype/_sisu/sisu_document_make b/data/samples/by/samples_by_filetype/_sisu/sisu_document_make
new file mode 100644
index 0000000..85e583e
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/_sisu/sisu_document_make
@@ -0,0 +1,9 @@
+@make:
+ :breaks: break=1
+ :home_button_text: {SiSU}http://sisudoc.org; {sources / git}http://sources.sisudoc.org/
+% :footer: {SiSU}http://sisudoc.org; {sources / git}http://sources.sisudoc.org/
+% :home_button_image: {sisu.png }http://sisudoc.org
+
+@links:+
+ {SiSU}http://sisudoc.org
+ {sources / git}http://sources.sisudoc.org/
diff --git a/data/samples/by/samples_by_filetype/_sisu/sisurc.yml b/data/samples/by/samples_by_filetype/_sisu/sisurc.yml
new file mode 120000
index 0000000..1984229
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/_sisu/sisurc.yml
@@ -0,0 +1 @@
+./rc/sisurc_ft_search.www.yml
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/accelerando.charles_stross.sst b/data/samples/by/samples_by_filetype/accelerando.charles_stross.sst
new file mode 120000
index 0000000..8d514e0
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/accelerando.charles_stross.sst
@@ -0,0 +1 @@
+../../current/en/accelerando.charles_stross.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/alices_adventures_in_wonderland.lewis_carroll.sst b/data/samples/by/samples_by_filetype/alices_adventures_in_wonderland.lewis_carroll.sst
new file mode 120000
index 0000000..393c837
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/alices_adventures_in_wonderland.lewis_carroll.sst
@@ -0,0 +1 @@
+../../current/en/alices_adventures_in_wonderland.lewis_carroll.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/autonomy_markup0.sst b/data/samples/by/samples_by_filetype/autonomy_markup0.sst
new file mode 120000
index 0000000..7386052
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/autonomy_markup0.sst
@@ -0,0 +1 @@
+../../current/en/autonomy_markup0.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/content.cory_doctorow.sst b/data/samples/by/samples_by_filetype/content.cory_doctorow.sst
new file mode 120000
index 0000000..ccc4037
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/content.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/content.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/democratizing_innovation.eric_von_hippel.sst b/data/samples/by/samples_by_filetype/democratizing_innovation.eric_von_hippel.sst
new file mode 120000
index 0000000..078bb69
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/democratizing_innovation.eric_von_hippel.sst
@@ -0,0 +1 @@
+../../current/en/democratizing_innovation.eric_von_hippel.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/down_and_out_in_the_magic_kingdom.cory_doctorow.sst b/data/samples/by/samples_by_filetype/down_and_out_in_the_magic_kingdom.cory_doctorow.sst
new file mode 120000
index 0000000..5fd9354
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/down_and_out_in_the_magic_kingdom.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/down_and_out_in_the_magic_kingdom.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/for_the_win.cory_doctorow.sst b/data/samples/by/samples_by_filetype/for_the_win.cory_doctorow.sst
new file mode 120000
index 0000000..3a78b95
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/for_the_win.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/for_the_win.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst b/data/samples/by/samples_by_filetype/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst
new file mode 120000
index 0000000..29c8cd9
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst
@@ -0,0 +1 @@
+../../current/en/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/free_culture.lawrence_lessig.sst b/data/samples/by/samples_by_filetype/free_culture.lawrence_lessig.sst
new file mode 120000
index 0000000..30ab1b4
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/free_culture.lawrence_lessig.sst
@@ -0,0 +1 @@
+../../current/en/free_culture.lawrence_lessig.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/free_for_all.peter_wayner.sst b/data/samples/by/samples_by_filetype/free_for_all.peter_wayner.sst
new file mode 120000
index 0000000..c58fa1f
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/free_for_all.peter_wayner.sst
@@ -0,0 +1 @@
+../../current/en/free_for_all.peter_wayner.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/gpl2.fsf.sst b/data/samples/by/samples_by_filetype/gpl2.fsf.sst
new file mode 120000
index 0000000..637c46b
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/gpl2.fsf.sst
@@ -0,0 +1 @@
+../../current/en/gpl2.fsf.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/gpl3.fsf.sst b/data/samples/by/samples_by_filetype/gpl3.fsf.sst
new file mode 120000
index 0000000..4b485a5
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/gpl3.fsf.sst
@@ -0,0 +1 @@
+../../current/en/gpl3.fsf.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/gullivers_travels.jonathan_swift.sst b/data/samples/by/samples_by_filetype/gullivers_travels.jonathan_swift.sst
new file mode 120000
index 0000000..0f836ef
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/gullivers_travels.jonathan_swift.sst
@@ -0,0 +1 @@
+../../current/en/gullivers_travels.jonathan_swift.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/little_brother.cory_doctorow.sst b/data/samples/by/samples_by_filetype/little_brother.cory_doctorow.sst
new file mode 120000
index 0000000..4bb4420
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/little_brother.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/little_brother.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/the_cathedral_and_the_bazaar.eric_s_raymond.sst b/data/samples/by/samples_by_filetype/the_cathedral_and_the_bazaar.eric_s_raymond.sst
new file mode 120000
index 0000000..6100203
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/the_cathedral_and_the_bazaar.eric_s_raymond.sst
@@ -0,0 +1 @@
+../../current/en/the_cathedral_and_the_bazaar.eric_s_raymond.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/the_public_domain.james_boyle.sst b/data/samples/by/samples_by_filetype/the_public_domain.james_boyle.sst
new file mode 120000
index 0000000..2a1e101
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/the_public_domain.james_boyle.sst
@@ -0,0 +1 @@
+../../current/en/the_public_domain.james_boyle.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/the_wealth_of_networks.yochai_benkler.sst b/data/samples/by/samples_by_filetype/the_wealth_of_networks.yochai_benkler.sst
new file mode 120000
index 0000000..4079f42
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/the_wealth_of_networks.yochai_benkler.sst
@@ -0,0 +1 @@
+../../current/en/the_wealth_of_networks.yochai_benkler.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/through_the_looking_glass.lewis_carroll.sst b/data/samples/by/samples_by_filetype/through_the_looking_glass.lewis_carroll.sst
new file mode 120000
index 0000000..5d35f2e
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/through_the_looking_glass.lewis_carroll.sst
@@ -0,0 +1 @@
+../../current/en/through_the_looking_glass.lewis_carroll.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/two_bits.christopher_kelty.sst b/data/samples/by/samples_by_filetype/two_bits.christopher_kelty.sst
new file mode 120000
index 0000000..afbcd99
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/two_bits.christopher_kelty.sst
@@ -0,0 +1 @@
+../../current/en/two_bits.christopher_kelty.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/un_contracts_international_sale_of_goods_convention_1980.sst b/data/samples/by/samples_by_filetype/un_contracts_international_sale_of_goods_convention_1980.sst
new file mode 120000
index 0000000..429f876
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/un_contracts_international_sale_of_goods_convention_1980.sst
@@ -0,0 +1 @@
+../../current/en/un_contracts_international_sale_of_goods_convention_1980.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_filetype/viral_spiral.david_bollier.sst b/data/samples/by/samples_by_filetype/viral_spiral.david_bollier.sst
new file mode 120000
index 0000000..cfcbb9e
--- /dev/null
+++ b/data/samples/by/samples_by_filetype/viral_spiral.david_bollier.sst
@@ -0,0 +1 @@
+../../current/en/viral_spiral.david_bollier.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/_sisu/image b/data/samples/by/samples_by_language/_sisu/image
new file mode 120000
index 0000000..7cf3516
--- /dev/null
+++ b/data/samples/by/samples_by_language/_sisu/image
@@ -0,0 +1 @@
+../../../../image
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/_sisu/rc/sisurc.yml b/data/samples/by/samples_by_language/_sisu/rc/sisurc.yml
new file mode 120000
index 0000000..dc360c1
--- /dev/null
+++ b/data/samples/by/samples_by_language/_sisu/rc/sisurc.yml
@@ -0,0 +1 @@
+sisurc_lng_search.www.yml
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/_sisu/rc/sisurc.yml_ b/data/samples/by/samples_by_language/_sisu/rc/sisurc.yml_
new file mode 100644
index 0000000..1813452
--- /dev/null
+++ b/data/samples/by/samples_by_language/_sisu/rc/sisurc.yml_
@@ -0,0 +1,117 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+  url_root:     'http://88.198.193.73' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+  path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #url_root:     'http://www.sisudoc.org' #without dir stub, e.g. this dir would map to http://www.sisudoc.org/samples
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+  file_links:    88.198.193.73
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+remote:
+  user:         'ralph'
+  host:         '88.198.193.73'
+  path:         '/srv/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+#output_dir_structure_by: filename
+#output_dir_structure_by: filetype
+output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng.ida.yml b/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng.ida.yml
new file mode 100644
index 0000000..bf5736b
--- /dev/null
+++ b/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng.ida.yml
@@ -0,0 +1,120 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+  url_root:     'http://192.168.1.108' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+# url_root:     'http://88.198.193.73' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+  path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #url_root:     'http://www.sisudoc.org' #without dir stub, e.g. this dir would map to http://www.sisudoc.org/samples
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+  file_links:    192.168.1.108
+# file_links:    88.198.193.73
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+remote:
+  user:         'ralph'
+  host:         '192.168.1.108'
+# host:         '88.198.193.73'
+  path:         '/srv/sisudoc/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+#output_dir_structure_by: filename
+#output_dir_structure_by: filetype
+output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng.www.yml b/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng.www.yml
new file mode 100644
index 0000000..6593c84
--- /dev/null
+++ b/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng.www.yml
@@ -0,0 +1,118 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+# url_root:     'http://www.sisudoc.org' #without directory stub (name of subdirectory containing markup)
+  path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+  file_links:    www.sisudoc.org
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+#remote:
+# user:         'ralph'
+# host:         'www.???.org'
+# host:         '192.168.1.108'
+# path:         '/srv/sisudoc/www'
+# path:         '/srv/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+#output_dir_structure_by: filename
+#output_dir_structure_by: filetype
+output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng_search.srv.yml b/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng_search.srv.yml
new file mode 100644
index 0000000..7344fc3
--- /dev/null
+++ b/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng_search.srv.yml
@@ -0,0 +1,133 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+# url_root:     'http://192.168.1.108' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+  url_root:     'http://www.sisudoc.org' #without dir stub, e.g. this dir would map to http://www.sisudoc.org/samples
+  path:         '/srv/www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+# path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+# file_links:    192.168.1.108
+  file_links:    www.sisudoc.org
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+remote:
+  user:         'ralph'
+  host:         'www.sisudoc.org'
+  path:         '/srv/www'
+# host:         '192.168.1.108'
+# host:         '88.198.193.70'
+# path:         '/srv/sisudoc/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+#output_dir_structure_by: filename
+#output_dir_structure_by: filetype
+output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+search:
+  sisu:
+    flag:            true
+    action:          http://www.sisudoc.org/cgi-bin/sisu_samples_lng.cgi
+    db:              markup_samples.sisu_lng
+#   action:          http://www.sisudoc.org/cgi-bin/sisu_pgsql.cgi
+#   action:          http://search.sisudoc.org
+#   action:          http://localhost:8081/cgi-bin/sisu_sqlite.cgi
+#   action:          http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+#   db:              sisu
+    title:           'SiSU search form (sample)'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng_search.www.yml b/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng_search.www.yml
new file mode 100644
index 0000000..91495e3
--- /dev/null
+++ b/data/samples/by/samples_by_language/_sisu/rc/sisurc_lng_search.www.yml
@@ -0,0 +1,131 @@
+# Name: SiSU
+# Author: ralph@amissah.com
+# Description: site or directory wide environment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+# url_root:     'http://192.168.1.108' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+  url_root:     'http://www.sisudoc.org' #without dir stub, e.g. this dir would map to http://www.sisudoc.org/samples
+  path:         '~/sisu_www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #path:         './tested' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+#  #images:       'sisu/image'
+#  #man:          'man'
+#  #cgi:          '/usr/local/lib/sisu-cgi'
+##show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+#  file_links:   webserv #  www.sisudoc.org
+# file_links:    192.168.1.108
+  file_links:    www.sisudoc.org
+#show_output_on: 'filesystem_url'
+#% processing directories, main path and subdirectories
+processing:
+# path:         '~'
+##  dir:         '_sisu_processing~'
+##  metaverse:    'metaverse'
+##  tune:         'tune'
+##  latex:        'tex'
+##  texinfo:      'texinfo'
+##  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+# default:      '-NQhewpotbxXyYv'           # includes verbose; -m would in any event be run by default
+# i:            '-NQhewpoty'                # -m run by default
+# ii:           '-NQhewpotbxXy'             # -m run by default
+# iii:          '-NQhewpotbxXyY'            # -m run by default
+# iv:           '-NQhewpotbxXYDy  --update' # -m run by default
+# v:            '-NQhewpotbxXYDyv --update' # includes verbose; -m run by default
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+  papersize:    'a4,letter' #'a4,letter,b5,a5,legal'
+  language_file: 2
+#  #texpdf_font:       'Liberation Sans'
+#  #texpdf_font_sans:  'Liberation Sans'
+#  #texpdf_font_serif: 'Liberation Serif'
+#  #texpdf_font_mono:  'Liberation Mono' #'Inconsolata'
+#  #text_wrap:    78
+#  #emphasis:     'bold' #make *{emphasis}* 'bold', 'italics' or 'underscore', default if not configured is 'bold'
+#  #language:      'fr'
+#  #language:      'en'
+#  digest:       'sha' #sha is sha256, default is md5
+#% settings used by ssh scp
+remote:
+  user:         'ralph'
+  host:         'www.sisudoc.org'
+  path:         '/srv/www'
+# host:         '192.168.1.108'
+# host:         '88.198.193.70'
+# path:         '/srv/sisudoc/www'
+#  #user:         'ralph'
+#  #host:         'sisudoc.org'
+#  #path:         '.' #no trailing slash eg 'sisu/www'
+#% webrick information
+#% sql database info, postgresql
+#db:
+#  engine:
+#    default:    'postgresql'
+## share_source:  true
+#  postgresql:
+#    port:       '5432' # '5432'
+#    user:       'ralph' # '[provide username]'
+#    #host:       'sisudoc.org'
+#
+#% output_dir_structure_by: language (language_and_filetype); filetype; or filename (original v1 & v2)
+#output_dir_structure_by: filename
+#output_dir_structure_by: filetype
+output_dir_structure_by: language
+#
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+##will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+##ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+##on value true system defaults used, to change, e.g. editor specify
+#permission_set:
+#  zap:               true
+#  css_modify:        true
+#  remote_base_site:  true
+#program_set:
+#  rmagick:           true
+#  wc:                true
+#  editor:            true
+#  postgresql:        true
+#  sqlite:            true
+#  tidy:              true
+#  rexml:             true
+#  pdflatex:          true
+#program_select:
+#  editor:            'vim' #'gvim -c :R'
+#  pdf_viewer:        'evince'
+#  web_browser:       'iceweasel'
+#  console_web_browser: 'links2'
+#  epub_viewer:       'ebook-viewer' #'calibre' 'fbreader'
+#  odf_viewer:        'lowriter'
+#  xml_viewer:        'xml-viewer'
+search:
+  sisu:
+    flag:            true
+    action:          http://www.sisudoc.org/cgi-bin/sisu_pgsql.cgi
+    db:              markup_samples.sisu_lng
+#   action:          http://search.sisudoc.org
+#   action:          http://localhost:8081/cgi-bin/sisu_sqlite.cgi
+#   action:          http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+#   db:              sisu
+    title:           'SiSU search form (sample)'
+#search:
+#  sisu:
+#    flag:            true
+#    action:          http://search.sisudoc.org
+#    db:              sisu
+#    title:           'SiSU search form (sample)'
+#html:
+#  minitoc:           true
+#manifest:
+#  minitoc:           true
diff --git a/data/samples/by/samples_by_language/_sisu/sisu_document_make b/data/samples/by/samples_by_language/_sisu/sisu_document_make
new file mode 100644
index 0000000..85e583e
--- /dev/null
+++ b/data/samples/by/samples_by_language/_sisu/sisu_document_make
@@ -0,0 +1,9 @@
+@make:
+ :breaks: break=1
+ :home_button_text: {SiSU}http://sisudoc.org; {sources / git}http://sources.sisudoc.org/
+% :footer: {SiSU}http://sisudoc.org; {sources / git}http://sources.sisudoc.org/
+% :home_button_image: {sisu.png }http://sisudoc.org
+
+@links:+
+ {SiSU}http://sisudoc.org
+ {sources / git}http://sources.sisudoc.org/
diff --git a/data/samples/by/samples_by_language/_sisu/sisurc.yml b/data/samples/by/samples_by_language/_sisu/sisurc.yml
new file mode 120000
index 0000000..b41e7d6
--- /dev/null
+++ b/data/samples/by/samples_by_language/_sisu/sisurc.yml
@@ -0,0 +1 @@
+./rc/sisurc_lng_search.www.yml
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/accelerando.charles_stross.sst b/data/samples/by/samples_by_language/accelerando.charles_stross.sst
new file mode 120000
index 0000000..8d514e0
--- /dev/null
+++ b/data/samples/by/samples_by_language/accelerando.charles_stross.sst
@@ -0,0 +1 @@
+../../current/en/accelerando.charles_stross.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/alices_adventures_in_wonderland.lewis_carroll.sst b/data/samples/by/samples_by_language/alices_adventures_in_wonderland.lewis_carroll.sst
new file mode 120000
index 0000000..393c837
--- /dev/null
+++ b/data/samples/by/samples_by_language/alices_adventures_in_wonderland.lewis_carroll.sst
@@ -0,0 +1 @@
+../../current/en/alices_adventures_in_wonderland.lewis_carroll.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/autonomy_markup0.sst b/data/samples/by/samples_by_language/autonomy_markup0.sst
new file mode 120000
index 0000000..7386052
--- /dev/null
+++ b/data/samples/by/samples_by_language/autonomy_markup0.sst
@@ -0,0 +1 @@
+../../current/en/autonomy_markup0.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/content.cory_doctorow.sst b/data/samples/by/samples_by_language/content.cory_doctorow.sst
new file mode 120000
index 0000000..ccc4037
--- /dev/null
+++ b/data/samples/by/samples_by_language/content.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/content.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/democratizing_innovation.eric_von_hippel.sst b/data/samples/by/samples_by_language/democratizing_innovation.eric_von_hippel.sst
new file mode 120000
index 0000000..078bb69
--- /dev/null
+++ b/data/samples/by/samples_by_language/democratizing_innovation.eric_von_hippel.sst
@@ -0,0 +1 @@
+../../current/en/democratizing_innovation.eric_von_hippel.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/down_and_out_in_the_magic_kingdom.cory_doctorow.sst b/data/samples/by/samples_by_language/down_and_out_in_the_magic_kingdom.cory_doctorow.sst
new file mode 120000
index 0000000..5fd9354
--- /dev/null
+++ b/data/samples/by/samples_by_language/down_and_out_in_the_magic_kingdom.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/down_and_out_in_the_magic_kingdom.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/for_the_win.cory_doctorow.sst b/data/samples/by/samples_by_language/for_the_win.cory_doctorow.sst
new file mode 120000
index 0000000..3a78b95
--- /dev/null
+++ b/data/samples/by/samples_by_language/for_the_win.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/for_the_win.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst b/data/samples/by/samples_by_language/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst
new file mode 120000
index 0000000..29c8cd9
--- /dev/null
+++ b/data/samples/by/samples_by_language/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst
@@ -0,0 +1 @@
+../../current/en/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/free_culture.lawrence_lessig.sst b/data/samples/by/samples_by_language/free_culture.lawrence_lessig.sst
new file mode 120000
index 0000000..30ab1b4
--- /dev/null
+++ b/data/samples/by/samples_by_language/free_culture.lawrence_lessig.sst
@@ -0,0 +1 @@
+../../current/en/free_culture.lawrence_lessig.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/free_for_all.peter_wayner.sst b/data/samples/by/samples_by_language/free_for_all.peter_wayner.sst
new file mode 120000
index 0000000..c58fa1f
--- /dev/null
+++ b/data/samples/by/samples_by_language/free_for_all.peter_wayner.sst
@@ -0,0 +1 @@
+../../current/en/free_for_all.peter_wayner.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/gpl2.fsf.sst b/data/samples/by/samples_by_language/gpl2.fsf.sst
new file mode 120000
index 0000000..637c46b
--- /dev/null
+++ b/data/samples/by/samples_by_language/gpl2.fsf.sst
@@ -0,0 +1 @@
+../../current/en/gpl2.fsf.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/gpl3.fsf.sst b/data/samples/by/samples_by_language/gpl3.fsf.sst
new file mode 120000
index 0000000..4b485a5
--- /dev/null
+++ b/data/samples/by/samples_by_language/gpl3.fsf.sst
@@ -0,0 +1 @@
+../../current/en/gpl3.fsf.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/gullivers_travels.jonathan_swift.sst b/data/samples/by/samples_by_language/gullivers_travels.jonathan_swift.sst
new file mode 120000
index 0000000..0f836ef
--- /dev/null
+++ b/data/samples/by/samples_by_language/gullivers_travels.jonathan_swift.sst
@@ -0,0 +1 @@
+../../current/en/gullivers_travels.jonathan_swift.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/little_brother.cory_doctorow.sst b/data/samples/by/samples_by_language/little_brother.cory_doctorow.sst
new file mode 120000
index 0000000..4bb4420
--- /dev/null
+++ b/data/samples/by/samples_by_language/little_brother.cory_doctorow.sst
@@ -0,0 +1 @@
+../../current/en/little_brother.cory_doctorow.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/the_cathedral_and_the_bazaar.eric_s_raymond.sst b/data/samples/by/samples_by_language/the_cathedral_and_the_bazaar.eric_s_raymond.sst
new file mode 120000
index 0000000..6100203
--- /dev/null
+++ b/data/samples/by/samples_by_language/the_cathedral_and_the_bazaar.eric_s_raymond.sst
@@ -0,0 +1 @@
+../../current/en/the_cathedral_and_the_bazaar.eric_s_raymond.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/the_public_domain.james_boyle.sst b/data/samples/by/samples_by_language/the_public_domain.james_boyle.sst
new file mode 120000
index 0000000..2a1e101
--- /dev/null
+++ b/data/samples/by/samples_by_language/the_public_domain.james_boyle.sst
@@ -0,0 +1 @@
+../../current/en/the_public_domain.james_boyle.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/the_wealth_of_networks.yochai_benkler.sst b/data/samples/by/samples_by_language/the_wealth_of_networks.yochai_benkler.sst
new file mode 120000
index 0000000..4079f42
--- /dev/null
+++ b/data/samples/by/samples_by_language/the_wealth_of_networks.yochai_benkler.sst
@@ -0,0 +1 @@
+../../current/en/the_wealth_of_networks.yochai_benkler.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/through_the_looking_glass.lewis_carroll.sst b/data/samples/by/samples_by_language/through_the_looking_glass.lewis_carroll.sst
new file mode 120000
index 0000000..5d35f2e
--- /dev/null
+++ b/data/samples/by/samples_by_language/through_the_looking_glass.lewis_carroll.sst
@@ -0,0 +1 @@
+../../current/en/through_the_looking_glass.lewis_carroll.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/two_bits.christopher_kelty.sst b/data/samples/by/samples_by_language/two_bits.christopher_kelty.sst
new file mode 120000
index 0000000..afbcd99
--- /dev/null
+++ b/data/samples/by/samples_by_language/two_bits.christopher_kelty.sst
@@ -0,0 +1 @@
+../../current/en/two_bits.christopher_kelty.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/un_contracts_international_sale_of_goods_convention_1980.sst b/data/samples/by/samples_by_language/un_contracts_international_sale_of_goods_convention_1980.sst
new file mode 120000
index 0000000..429f876
--- /dev/null
+++ b/data/samples/by/samples_by_language/un_contracts_international_sale_of_goods_convention_1980.sst
@@ -0,0 +1 @@
+../../current/en/un_contracts_international_sale_of_goods_convention_1980.sst
\ No newline at end of file
diff --git a/data/samples/by/samples_by_language/viral_spiral.david_bollier.sst b/data/samples/by/samples_by_language/viral_spiral.david_bollier.sst
new file mode 120000
index 0000000..cfcbb9e
--- /dev/null
+++ b/data/samples/by/samples_by_language/viral_spiral.david_bollier.sst
@@ -0,0 +1 @@
+../../current/en/viral_spiral.david_bollier.sst
\ No newline at end of file