82 files changed, 1553 insertions, 0 deletions
diff --git a/data/samples/generic/_sisu/image/2bits.png b/data/image/2bits.png
index 3c182f9..3c182f9 100644
--- a/data/samples/generic/_sisu/image/2bits.png
+++ b/data/image/2bits.png
diff --git a/data/samples/generic/_sisu/image/2bits_02_01-100.png b/data/image/2bits_02_01-100.png
index 4d81dc7..4d81dc7 100644
--- a/data/samples/generic/_sisu/image/2bits_02_01-100.png
+++ b/data/image/2bits_02_01-100.png
diff --git a/data/samples/generic/_sisu/image/2bits_03_02-100.png b/data/image/2bits_03_02-100.png
index 4298cb9..4298cb9 100644
--- a/data/samples/generic/_sisu/image/2bits_03_02-100.png
+++ b/data/image/2bits_03_02-100.png
diff --git a/data/samples/generic/_sisu/image/2bits_05_03-100.png b/data/image/2bits_05_03-100.png
index 00dadbf..00dadbf 100644
--- a/data/samples/generic/_sisu/image/2bits_05_03-100.png
+++ b/data/image/2bits_05_03-100.png
diff --git a/data/samples/generic/_sisu/image/2bits_05_04-100.png b/data/image/2bits_05_04-100.png
index f7b5134..f7b5134 100644
--- a/data/samples/generic/_sisu/image/2bits_05_04-100.png
+++ b/data/image/2bits_05_04-100.png
diff --git a/data/samples/generic/_sisu/image/2bits_05_05-100.png b/data/image/2bits_05_05-100.png
index 42f0948..42f0948 100644
--- a/data/samples/generic/_sisu/image/2bits_05_05-100.png
+++ b/data/image/2bits_05_05-100.png
diff --git a/data/samples/generic/_sisu/image/2bits_05_06-100.png b/data/image/2bits_05_06-100.png
index 5716f20..5716f20 100644
--- a/data/samples/generic/_sisu/image/2bits_05_06-100.png
+++ b/data/image/2bits_05_06-100.png
diff --git a/data/samples/generic/_sisu/image/2bits_08_07-100.png b/data/image/2bits_08_07-100.png
index 707b2ad..707b2ad 100644
--- a/data/samples/generic/_sisu/image/2bits_08_07-100.png
+++ b/data/image/2bits_08_07-100.png
diff --git a/data/samples/generic/_sisu/image/2bits_09_08-100.png b/data/image/2bits_09_08-100.png
index 383a958..383a958 100644
--- a/data/samples/generic/_sisu/image/2bits_09_08-100.png
+++ b/data/image/2bits_09_08-100.png
diff --git a/data/samples/generic/_sisu/image/2bits_09_09-100.png b/data/image/2bits_09_09-100.png
index 779a4d5..779a4d5 100644
--- a/data/samples/generic/_sisu/image/2bits_09_09-100.png
+++ b/data/image/2bits_09_09-100.png
diff --git a/data/samples/generic/_sisu/image/2bits_large.png b/data/image/2bits_large.png
index 63de770..63de770 100644
--- a/data/samples/generic/_sisu/image/2bits_large.png
+++ b/data/image/2bits_large.png
diff --git a/data/samples/generic/_sisu/image/accelerando_stross.png b/data/image/accelerando_stross.png
index 4a03130..4a03130 100644
--- a/data/samples/generic/_sisu/image/accelerando_stross.png
+++ b/data/image/accelerando_stross.png
diff --git a/data/samples/generic/_sisu/image/b_doc.png b/data/image/b_doc.png
index 13ca8eb..13ca8eb 100644
--- a/data/samples/generic/_sisu/image/b_doc.png
+++ b/data/image/b_doc.png
diff --git a/data/samples/generic/_sisu/image/c_Copyleft.png b/data/image/c_Copyleft.png
index 5b3865b..5b3865b 100644
--- a/data/samples/generic/_sisu/image/c_Copyleft.png
+++ b/data/image/c_Copyleft.png
diff --git a/data/samples/generic/_sisu/image/cover_image_wordle_little_brother.png b/data/image/cover_image_wordle_little_brother.png
index c718dea..c718dea 100644
--- a/data/samples/generic/_sisu/image/cover_image_wordle_little_brother.png
+++ b/data/image/cover_image_wordle_little_brother.png
diff --git a/data/samples/generic/_sisu/image/di_evh.png b/data/image/di_evh.png
index 9938981..9938981 100644
--- a/data/samples/generic/_sisu/image/di_evh.png
+++ b/data/image/di_evh.png
diff --git a/data/samples/generic/_sisu/image/di_evh_f1-1.png b/data/image/di_evh_f1-1.png
index eb884e9..eb884e9 100644
--- a/data/samples/generic/_sisu/image/di_evh_f1-1.png
+++ b/data/image/di_evh_f1-1.png
diff --git a/data/samples/generic/_sisu/image/di_evh_f10-1.png b/data/image/di_evh_f10-1.png
index ce41d83..ce41d83 100644
--- a/data/samples/generic/_sisu/image/di_evh_f10-1.png
+++ b/data/image/di_evh_f10-1.png
diff --git a/data/samples/generic/_sisu/image/di_evh_f11-1.png b/data/image/di_evh_f11-1.png
index 4534358..4534358 100644
--- a/data/samples/generic/_sisu/image/di_evh_f11-1.png
+++ b/data/image/di_evh_f11-1.png
diff --git a/data/samples/generic/_sisu/image/di_evh_f11-2.png b/data/image/di_evh_f11-2.png
index 7f17b42..7f17b42 100644
--- a/data/samples/generic/_sisu/image/di_evh_f11-2.png
+++ b/data/image/di_evh_f11-2.png
diff --git a/data/samples/generic/_sisu/image/di_evh_f5-1.png b/data/image/di_evh_f5-1.png
index caab88f..caab88f 100644
--- a/data/samples/generic/_sisu/image/di_evh_f5-1.png
+++ b/data/image/di_evh_f5-1.png
diff --git a/data/samples/generic/_sisu/image/ffa.png b/data/image/ffa.png
index ab2256c..ab2256c 100644
--- a/data/samples/generic/_sisu/image/ffa.png
+++ b/data/image/ffa.png
diff --git a/data/samples/generic/_sisu/image/free.for.all.png b/data/image/free.for.all.png
index ab2256c..ab2256c 100644
--- a/data/samples/generic/_sisu/image/free.for.all.png
+++ b/data/image/free.for.all.png
diff --git a/data/samples/generic/_sisu/image/free_as_in_freedom_2_01_pdp_1_processor_with_kl_10.png b/data/image/free_as_in_freedom_2_01_pdp_1_processor_with_kl_10.png
index 679c22a..679c22a 100644
--- a/data/samples/generic/_sisu/image/free_as_in_freedom_2_01_pdp_1_processor_with_kl_10.png
+++ b/data/image/free_as_in_freedom_2_01_pdp_1_processor_with_kl_10.png
diff --git a/data/samples/generic/_sisu/image/free_as_in_freedom_2_02_rms_st_ignucius.png b/data/image/free_as_in_freedom_2_02_rms_st_ignucius.png
index 9ed7b35..9ed7b35 100644
--- a/data/samples/generic/_sisu/image/free_as_in_freedom_2_02_rms_st_ignucius.png
+++ b/data/image/free_as_in_freedom_2_02_rms_st_ignucius.png
diff --git a/data/samples/generic/_sisu/image/freeculture.home.png b/data/image/freeculture.home.png
index 3d47f5d..3d47f5d 100644
--- a/data/samples/generic/_sisu/image/freeculture.home.png
+++ b/data/image/freeculture.home.png
diff --git a/data/samples/generic/_sisu/image/freeculture01.png b/data/image/freeculture01.png
index 6167da7..6167da7 100644
--- a/data/samples/generic/_sisu/image/freeculture01.png
+++ b/data/image/freeculture01.png
diff --git a/data/samples/generic/_sisu/image/freeculture02.png b/data/image/freeculture02.png
index b3e27f2..b3e27f2 100644
--- a/data/samples/generic/_sisu/image/freeculture02.png
+++ b/data/image/freeculture02.png
diff --git a/data/samples/generic/_sisu/image/freeculture03.png b/data/image/freeculture03.png
index 294ef07..294ef07 100644
--- a/data/samples/generic/_sisu/image/freeculture03.png
+++ b/data/image/freeculture03.png
diff --git a/data/samples/generic/_sisu/image/freeculture04.png b/data/image/freeculture04.png
index 11e3723..11e3723 100644
--- a/data/samples/generic/_sisu/image/freeculture04.png
+++ b/data/image/freeculture04.png
diff --git a/data/samples/generic/_sisu/image/freeculture05.png b/data/image/freeculture05.png
index 01a0978..01a0978 100644
--- a/data/samples/generic/_sisu/image/freeculture05.png
+++ b/data/image/freeculture05.png
diff --git a/data/samples/generic/_sisu/image/freeculture06.png b/data/image/freeculture06.png
index cc5bfad..cc5bfad 100644
--- a/data/samples/generic/_sisu/image/freeculture06.png
+++ b/data/image/freeculture06.png
diff --git a/data/samples/generic/_sisu/image/freeculture07.png b/data/image/freeculture07.png
index 177745f..177745f 100644
--- a/data/samples/generic/_sisu/image/freeculture07.png
+++ b/data/image/freeculture07.png
diff --git a/data/samples/generic/_sisu/image/freeculture08.png b/data/image/freeculture08.png
index a82c2fe..a82c2fe 100644
--- a/data/samples/generic/_sisu/image/freeculture08.png
+++ b/data/image/freeculture08.png
diff --git a/data/samples/generic/_sisu/image/freeculture09.png b/data/image/freeculture09.png
index a440b83..a440b83 100644
--- a/data/samples/generic/_sisu/image/freeculture09.png
+++ b/data/image/freeculture09.png
diff --git a/data/samples/generic/_sisu/image/freeculture10.png b/data/image/freeculture10.png
index db76856..db76856 100644
--- a/data/samples/generic/_sisu/image/freeculture10.png
+++ b/data/image/freeculture10.png
diff --git a/data/samples/generic/_sisu/image/freeculture11.png b/data/image/freeculture11.png
index 52d70a9..52d70a9 100644
--- a/data/samples/generic/_sisu/image/freeculture11.png
+++ b/data/image/freeculture11.png
diff --git a/data/samples/generic/_sisu/image/freeculture12.png b/data/image/freeculture12.png
index 140db0f..140db0f 100644
--- a/data/samples/generic/_sisu/image/freeculture12.png
+++ b/data/image/freeculture12.png
diff --git a/data/samples/generic/_sisu/image/freeculture13.png b/data/image/freeculture13.png
index 3c716c0..3c716c0 100644
--- a/data/samples/generic/_sisu/image/freeculture13.png
+++ b/data/image/freeculture13.png
diff --git a/data/samples/generic/_sisu/image/freeculture14.png b/data/image/freeculture14.png
index cccfa69..cccfa69 100644
--- a/data/samples/generic/_sisu/image/freeculture14.png
+++ b/data/image/freeculture14.png
diff --git a/data/samples/generic/_sisu/image/freeculture15.png b/data/image/freeculture15.png
index 19db29c..19db29c 100644
--- a/data/samples/generic/_sisu/image/freeculture15.png
+++ b/data/image/freeculture15.png
diff --git a/data/samples/generic/_sisu/image/freeculture16.png b/data/image/freeculture16.png
index 919a54d..919a54d 100644
--- a/data/samples/generic/_sisu/image/freeculture16.png
+++ b/data/image/freeculture16.png
diff --git a/data/samples/generic/_sisu/image/freeculture17.png b/data/image/freeculture17.png
index 1f94fc2..1f94fc2 100644
--- a/data/samples/generic/_sisu/image/freeculture17.png
+++ b/data/image/freeculture17.png
diff --git a/data/samples/generic/_sisu/image/freeculture18.png b/data/image/freeculture18.png
index b18dc8d..b18dc8d 100644
--- a/data/samples/generic/_sisu/image/freeculture18.png
+++ b/data/image/freeculture18.png
diff --git a/data/samples/generic/_sisu/image/freeculture_bcode.png b/data/image/freeculture_bcode.png
index c318556..c318556 100644
--- a/data/samples/generic/_sisu/image/freeculture_bcode.png
+++ b/data/image/freeculture_bcode.png
diff --git a/data/samples/generic/_sisu/image/freeculture_book.png b/data/image/freeculture_book.png
index 89dc002..89dc002 100644
--- a/data/samples/generic/_sisu/image/freeculture_book.png
+++ b/data/image/freeculture_book.png
diff --git a/data/samples/generic/_sisu/image/gutenberg.home.png b/data/image/gutenberg.home.png
index e6e021c..e6e021c 100644
--- a/data/samples/generic/_sisu/image/gutenberg.home.png
+++ b/data/image/gutenberg.home.png
diff --git a/data/samples/generic/_sisu/image/gutenberg_icon.png b/data/image/gutenberg_icon.png
index 2f6466b..2f6466b 100644
--- a/data/samples/generic/_sisu/image/gutenberg_icon.png
+++ b/data/image/gutenberg_icon.png
diff --git a/data/samples/generic/_sisu/image/lessig.jpg b/data/image/lessig.jpg
index 7c0f716..7c0f716 100644
--- a/data/samples/generic/_sisu/image/lessig.jpg
+++ b/data/image/lessig.jpg
diff --git a/data/samples/generic/_sisu/image/levitating_gnu.png b/data/image/levitating_gnu.png
index 9a25319..9a25319 100644
--- a/data/samples/generic/_sisu/image/levitating_gnu.png
+++ b/data/image/levitating_gnu.png
diff --git a/data/samples/generic/_sisu/image/little_brother_doctorow.png b/data/image/little_brother_doctorow.png
index 66893a2..66893a2 100644
--- a/data/samples/generic/_sisu/image/little_brother_doctorow.png
+++ b/data/image/little_brother_doctorow.png
diff --git a/data/samples/generic/_sisu/image/philosophical_gnu.png b/data/image/philosophical_gnu.png
index ebd239e..ebd239e 100644
--- a/data/samples/generic/_sisu/image/philosophical_gnu.png
+++ b/data/image/philosophical_gnu.png
diff --git a/data/samples/generic/_sisu/image/rdgl.png b/data/image/rdgl.png
index 979471d..979471d 100644
--- a/data/samples/generic/_sisu/image/rdgl.png
+++ b/data/image/rdgl.png
diff --git a/data/samples/generic/_sisu/image/sisu.home.png b/data/image/sisu.home.png
index 202d8c4..202d8c4 100644
--- a/data/samples/generic/_sisu/image/sisu.home.png
+++ b/data/image/sisu.home.png
diff --git a/data/samples/generic/_sisu/image/sisu.png b/data/image/sisu.png
index b449fa6..b449fa6 100644
--- a/data/samples/generic/_sisu/image/sisu.png
+++ b/data/image/sisu.png
diff --git a/data/samples/generic/_sisu/image/vs_db_1.png b/data/image/vs_db_1.png
index 4a9bfd1..4a9bfd1 100644
--- a/data/samples/generic/_sisu/image/vs_db_1.png
+++ b/data/image/vs_db_1.png
diff --git a/data/samples/generic/_sisu/image/wayner.home.png b/data/image/wayner.home.png
index debf9b2..debf9b2 100644
--- a/data/samples/generic/_sisu/image/wayner.home.png
+++ b/data/image/wayner.home.png
diff --git a/data/samples/generic/_sisu/image/wayner.png b/data/image/wayner.png
index debf9b2..debf9b2 100644
--- a/data/samples/generic/_sisu/image/wayner.png
+++ b/data/image/wayner.png
diff --git a/data/samples/generic/_sisu/image/won_benkler.png b/data/image/won_benkler.png
index 06d5c14..06d5c14 100644
--- a/data/samples/generic/_sisu/image/won_benkler.png
+++ b/data/image/won_benkler.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_2_1.png b/data/image/won_benkler_2_1.png
index 20887d4..20887d4 100644
--- a/data/samples/generic/_sisu/image/won_benkler_2_1.png
+++ b/data/image/won_benkler_2_1.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_6_1.png b/data/image/won_benkler_6_1.png
index b959f84..b959f84 100644
--- a/data/samples/generic/_sisu/image/won_benkler_6_1.png
+++ b/data/image/won_benkler_6_1.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_7_1.png b/data/image/won_benkler_7_1.png
index 8aa93f8..8aa93f8 100644
--- a/data/samples/generic/_sisu/image/won_benkler_7_1.png
+++ b/data/image/won_benkler_7_1.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_7_2.png b/data/image/won_benkler_7_2.png
index fe2ac37..fe2ac37 100644
--- a/data/samples/generic/_sisu/image/won_benkler_7_2.png
+++ b/data/image/won_benkler_7_2.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_7_3a.png b/data/image/won_benkler_7_3a.png
index 4c42126..4c42126 100644
--- a/data/samples/generic/_sisu/image/won_benkler_7_3a.png
+++ b/data/image/won_benkler_7_3a.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_7_3b.png b/data/image/won_benkler_7_3b.png
index 3ce123a..3ce123a 100644
--- a/data/samples/generic/_sisu/image/won_benkler_7_3b.png
+++ b/data/image/won_benkler_7_3b.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_7_4.png b/data/image/won_benkler_7_4.png
index 073d810..073d810 100644
--- a/data/samples/generic/_sisu/image/won_benkler_7_4.png
+++ b/data/image/won_benkler_7_4.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_7_5.png b/data/image/won_benkler_7_5.png
index b9e778b..b9e778b 100644
--- a/data/samples/generic/_sisu/image/won_benkler_7_5.png
+++ b/data/image/won_benkler_7_5.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_7_6.png b/data/image/won_benkler_7_6.png
index f53daf3..f53daf3 100644
--- a/data/samples/generic/_sisu/image/won_benkler_7_6.png
+++ b/data/image/won_benkler_7_6.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_9_1.png b/data/image/won_benkler_9_1.png
index 814ed19..814ed19 100644
--- a/data/samples/generic/_sisu/image/won_benkler_9_1.png
+++ b/data/image/won_benkler_9_1.png
diff --git a/data/samples/generic/_sisu/image/won_benkler_book.png b/data/image/won_benkler_book.png
index 986e17e..986e17e 100644
--- a/data/samples/generic/_sisu/image/won_benkler_book.png
+++ b/data/image/won_benkler_book.png
diff --git a/data/misc/Rakefile b/data/misc/Rakefile
new file mode 100644
index 0000000..1d9b541
--- /dev/null
+++ b/data/misc/Rakefile
@@ -0,0 +1,404 @@
+#!/usr/bin/env ruby
+raise 'Please, use ruby1.9.3 or later.' if RUBY_VERSION < '1.9.3'
+=begin
+ Common Rakefile, Rantfile to place sisu markup translation under
+ po4a management softlink Rakefile and Rantfile to this file
+
+ * Homepage: <http://www.jus.uio.no/sisu/SiSU>
+             <http://sisudoc.org>
+ * Download: <http://www.jus.uio.no/sisu/download>
+
+ Copyright (C) 2013 Ralph Amissah
+
+ * License: LGPL - GNU Lesser General Public License
+     [same license as Rant provided within the Rant package]
+
+ * Ralph Amissah <ralph@amissah.com>
+   Ralph Amissah <ralph.amissah@gmail.com>
+
+ Rake is a Ruby build program by Jim Weirich
+ * Rake may be downloaded and installed from:
+     <http://rake.rubyforge.org/>
+
+ Rant is a Ruby build program by Stefan Lang
+ * Rant may be downloaded and installed from:
+     <http://make.rubyforge.org/>
+
+ Notes on use:
+     rake -T
+   [if rant is preferred and installed]
+     rant -T
+=end
+require 'find'
+require 'fileutils'
+#require 'ftools'
+require 'rbconfig.rb'
+#include RbConfig
+require 'yaml'
+include FileUtils
+def project_details
+  def name
+    'SiSU translations under po4a management'
+  end
+  def name_warning
+    <<-WOK
+#{name}
+
+WARNING all sisu markup files (.ssm, .sst, .ssi) in languages other than #{language.source}
+are managed by po4a, through translations of the source language to other languages.
+
+#{language.info_on_selection}
+    WOK
+  end
+  def rake_project
+    "Rakefile for placing #{name}"
+  end
+  self
+end
+def query
+  def answer?(ask)
+    resp='redo'
+    print ask + %{    ['yes', 'no' or 'quit']: }
+    resp=File.new('/dev/tty').gets.strip
+    if resp == 'yes';           true
+    elsif resp == 'no';         false
+    elsif resp =~/^quit|exit$/; exit
+    else
+      puts %{[please type: 'yes', 'no' or 'quit']}
+      answer?(ask)
+    end
+  end
+  self
+end
+def notice
+  def warn_and_proceed?
+    %{WARNING: This Software is used entirely at your own risk.
+    PROCEED?}
+  end
+  def default(selection=nil)
+    ans= if selection
+      case selection
+      when selection.is_a?(String)
+        <<-WOK
+  #{project_details.rake_project}
+    Information on alternative actions is available using: "rake help" or "rake -T"
+    Default action selected - "#{selection} #{project_details.name}"
+    #{warn_and_proceed?}
+        WOK
+      when :make
+        <<-WOK
+  #{project_details.rake_project}
+    Information on alternative actions is available using: "rake help" or "rake -T"
+    #{selection.upcase} selected - #{selection} #{project_details.name}
+    WARNING: this action assumes (and places) this project is under po4a
+    (translation) management. It will create the sub-directories:
+      #{language.translations_available_str}
+    & file: #{filename.po4a_cfg}
+    in the current directory:
+      #{Dir.pwd}
+    It will populate the sub-directories with translation files created from
+    the pot and po files found under the corresponding language sub-directories,
+    (under #{dir.pot}/ & #{dir.po}/). (OVERWRITING any existing translated
+    .ssm .sst .ssi files in language subdirectories that are not under po4a
+     management).
+    #{warn_and_proceed?}
+        WOK
+      when :clean
+        <<-WOK
+  #{project_details.rake_project}
+    Information on alternative actions is available using: "rake help" or "rake -T"
+    #{selection.upcase} selected - #{selection} #{project_details.name}
+    #{warn_and_proceed?}
+        WOK
+      when :distclean
+        <<-WOK
+  #{project_details.rake_project}
+    Information on alternative actions is available using: "rake help" or "rake -T"
+    #{selection.upcase} selected - #{selection} #{project_details.name}
+    WARNING: this action assumes (and places) this project is under po4a
+    (translation) management. It will remove the sub-directories:
+      #{language.translations_available_str}
+    & file: #{filename.po4a_cfg}
+    in the current directory:
+      #{Dir.pwd}
+    Note: these sub-directories & the config file #{filename.po4a_cfg}
+    should be auto-generated from pot and po files if this project translation
+    is under po4a management.
+    This query is to give you the chance to make sure you know what you are doing.
+    #{warn_and_proceed?}
+        WOK
+      when :rebuild
+        <<-WOK
+  #{project_details.rake_project}
+    Information on alternative actions is available using: "rake help" or "rake -T"
+    #{selection.upcase} selected - #{selection} #{project_details.name}
+    WARNING: this action assumes (and places) this project is under po4a
+    (translation) management. It will destroy/clobber and then create again the
+    sub-directories:
+      #{language.translations_available_str}
+    populating them with translation files created from the pot and po files
+    found under the corresponding language sub-directories in (#{dir.pot}/
+    & #{dir.po}/).
+    It will also generate the file: #{filename.po4a_cfg}
+    These actions will be taken in the current directory:
+      #{Dir.pwd}
+    This query is to give you the chance to make sure you know what you are doing.
+    #{warn_and_proceed?}
+        WOK
+      else
+        <<-WOK
+  #{project_details.rake_project}
+    Information on alternative actions is available using: "rake help" or "rake -T"
+    Default action selected - "#{selection} #{project_details.name}"
+    #{warn_and_proceed?}
+        WOK
+      end
+    else
+      <<-WOK
+  #{project_details.rake_project}
+    Information on alternative actions is available using: "rake help" or "rake -T"
+    Default action selected - "install and to setup #{project_details.name}"
+    #{warn_and_proceed?}
+      WOK
+    end
+    resp=query.answer?(ans)
+    exit unless resp
+  end
+  def project_help
+    puts <<-WOK
+#{project_details.name}
+#{project_details.rake_project}
+
+This rake file is to assist with having sisu markup files under po4a
+translation management. It assumes that the source language files are placed
+under the sub-directory identifying the source language set, which is currently
+#{language.source}
+The files there are used to make the source translation file in the directory #{dir.pot}/
+Which is then used to create files for translation under the directory #{dir.po}/
+in sub-directories bearing the translation languages ISO code.
+
+The current language translation selection is:  #{translations_selected_str}
+The languages selected are located in the file: #{filename.languages}
+
+sisu available language list: #{sisu_available_str}
+
+For a more detailed and up to date task list use:
+
+  rake -T
+
+  WOK
+  end
+  self
+end
+def tasks
+  system('rake -T')
+end
+def filename
+  def languages
+    'translation_languages'
+  end
+  def po4a_cfg
+    'po4a.cfg'
+  end
+  self
+end
+def dir
+  def pwd
+    Dir.pwd
+  end
+  def po4a_
+    'po4a/' # ''
+  end
+  def pot
+    po4a_ + 'pot'
+  end
+  def po
+    po4a_ + 'po'
+  end
+  self
+end
+def dir_mk(dir)
+  FileUtils::mkdir_p(dir) unless FileTest.directory?(dir)
+end
+def po4a_flags
+  def debug
+    '-d -v'
+  end
+  def normal
+    ''
+  end
+  def quiet
+    '-q'
+  end
+  self
+end
+def language
+  def source #source_language
+    'en'
+  end
+  def translations_selected #translation_languages
+    IO.read(filename.languages, mode: 'r:utf-8').split(/\s+/)
+  end
+  def translations_available
+    translations_selected & sisu_available
+  end
+  def info_on_selection
+    if translations_selected != translations_available
+      <<-WOK
+WARNING: language selections mismatch
+
+The current language translation selection appears to be: #{translations_selected_str}
+Of which the following are valid (available) selections:  #{translations_available_str}
+
+sisu available language list: #{sisu_available_str}
+
+the following will be used: #{translations_available_str}
+The languages selected are located in the file:    #{filename.languages}
+      WOK
+    else
+      <<-WOK
+The current language translation selection is:  #{translations_selected_str}
+The languages selected are located in the file: #{filename.languages}
+
+sisu available language list: #{sisu_available_str}
+      WOK
+    end
+  end
+  def sisu_available
+    %w[am bg bn br ca cs cy da de el en eo es et eu fi fr ga gl he hi hr hy ia is it ja ko la lo lt lv ml mr nl nn no oc pl pt pt_BR ro ru sa se sk sl sq sr sv ta te th tk tr uk ur us vi zh]
+  end
+  def translations_selected_str
+    language.translations_selected.join(' ')
+  end
+  def translations_available_str
+    language.translations_available.join(' ')
+  end
+  def sisu_available_str
+    language.sisu_available.join(' ')
+  end
+  self
+end
+def files_src
+  def ssm
+    Dir.glob("#{language.source}/*.ssm").sort
+  end
+  def sst
+    Dir.glob("#{language.source}/*.sst").sort
+  end
+  def ssi
+    Dir.glob("#{language.source}/*.ssi").sort
+  end
+  def all
+    Dir.glob("#{language.source}/*{.ssm,.sst,.ssi}").sort
+  end
+  self
+end
+def po4a_cfg_file
+  File.open("#{Dir.pwd}/#{filename.po4a_cfg}",'w')
+end
+def po4a
+  def configure #po4a_cfg
+    po4a_cfg_arr=[]
+    po4a_cfg_arr << "[po4a_langs] #{language.translations_available_str}"
+    po4a_cfg_arr << "[po4a_paths] #{dir.pot}/$master.pot $lang:#{dir.po}/$lang/$master.po"
+    files_src.ssm.each do |file_src|
+      file_src_fn=file_src.gsub(/#{language.source}\//,'')
+      po4a_cfg_arr << "[type: text] #{file_src} $lang:$lang/#{file_src_fn}"
+    end
+    files_src.sst.each do |file_src|
+      file_src_fn=file_src.gsub(/#{language.source}\//,'')
+      po4a_cfg_arr << "[type: text] #{file_src} $lang:$lang/#{file_src_fn}"
+    end
+    files_src.ssi.each do |file_src|
+      file_src_fn=file_src.gsub(/#{language.source}\//,'')
+      po4a_cfg_arr << "[type: text] #{file_src} $lang:$lang/#{file_src_fn}"
+    end
+    file=po4a_cfg_file
+    po4a_cfg_arr.each do |txt|
+    puts txt
+      file << txt << "\n"
+    end
+    file.close
+  	system("po4a --keep 0 --no-backups --package-name sisu-manual #{po4a_flags.normal} #{filename.po4a_cfg}")
+  end
+  self
+end
+def project
+  dir_mk(dir.pot)
+  language.translations_available.each do |lang_dir|
+    dir_lang="#{Dir.pwd}/#{dir.po}/#{lang_dir}"
+    dir_mk(dir_lang)
+  end
+  po4a.configure
+end
+def clean
+	#rm -rf ../build
+  FileUtils.rm_f Dir.glob("#{dir.po}/*/*.po~")
+end
+def distclean
+  FileUtils::rm_f(filename.po4a_cfg)
+  FileUtils::rm_r(language.translations_available,:force => true)
+end
+
+#% task lists
+desc "runs make (see its description below)"
+task :default => [:make]
+desc "assist with having sisu markup files managed by po4a
+                   create configuration files, and language directories and
+                   populate them with po4a pot & po files for translation and
+                   from those (as translated) create translated sisu markup
+                   .ssm .sst & .ssi files in corresponding language sub-directories"
+task :make => [:notice_make_,:build_]
+desc "help"
+task :help => [:project_help_,:tasks_]
+desc "clean temporary files"
+task :clean => [:notice_clean_,:clean_]
+desc "removes auto-generated files under po4a management
+                  including translated .ssm .sst & .ssi files,
+                  that are created from po4a pot and po files"
+task :distclean => [:notice_distclean_,:distclean_]
+desc "runs 'distclean' and 'make' (see their descriptions above)"
+task :rebuild => [:notice_rebuild_,:distclean_,:build_]
+if File.directory?(dir.pot) \
+and File.directory?(dir.po)
+  #desc ""
+  task :clean! => [:clean_]
+  task :distclean! => [:distclean_]
+  task :rebuild! => [:distclean_,:build_]
+  task :make! => [:build_]
+else
+  task :make! => [:build_]
+end
+
+#% task actions
+task :project_help_ do
+  notice.project_help
+end
+task :tasks_ do
+  tasks
+end
+task :build_ do
+  project
+end
+task :clean_ do
+  clean
+end
+task :distclean_ do
+  distclean
+end
+task :notice_default_ do
+  notice.default
+end
+task :notice_make_ do
+  notice.default(:make)
+end
+task :notice_clean_ do
+  notice.default(:clean)
+end
+task :notice_distclean_ do
+  notice.default(:distclean)
+end
+task :notice_rebuild_ do
+  notice.default(:rebuild)
+end
+__END__
diff --git a/data/rc/sisurc_fn.www.yml b/data/rc/sisurc_fn.www.yml
new file mode 100644
index 0000000..7a0939e
--- /dev/null
+++ b/data/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/rc/sisurc_fn_search.srv.yml b/data/rc/sisurc_fn_search.srv.yml
new file mode 100644
index 0000000..cf88ee3
--- /dev/null
+++ b/data/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/rc/sisurc_fn_search.www.yml b/data/rc/sisurc_fn_search.www.yml
new file mode 100644
index 0000000..30c317b
--- /dev/null
+++ b/data/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/rc/sisurc_ft.www.yml b/data/rc/sisurc_ft.www.yml
new file mode 100644
index 0000000..4f71fe5
--- /dev/null
+++ b/data/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/rc/sisurc_ft_search.srv.yml b/data/rc/sisurc_ft_search.srv.yml
new file mode 100644
index 0000000..54566db
--- /dev/null
+++ b/data/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/rc/sisurc_ft_search.www.yml b/data/rc/sisurc_ft_search.www.yml
new file mode 100644
index 0000000..69520f3
--- /dev/null
+++ b/data/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/rc/sisurc_lng.www.yml b/data/rc/sisurc_lng.www.yml
new file mode 100644
index 0000000..6593c84
--- /dev/null
+++ b/data/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/rc/sisurc_lng_search.srv.yml b/data/rc/sisurc_lng_search.srv.yml
new file mode 100644
index 0000000..7344fc3
--- /dev/null
+++ b/data/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/rc/sisurc_lng_search.www.yml b/data/rc/sisurc_lng_search.www.yml
new file mode 100644
index 0000000..91495e3
--- /dev/null
+++ b/data/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/generic/README b/data/samples/generic/README
new file mode 100644
index 0000000..9f2a8af
--- /dev/null
+++ b/data/samples/generic/README
@@ -0,0 +1,2 @@
+This directory contains sisu marked up files that should work with older v3 (or
+v2) versions of sisu and up.
diff --git a/data/samples/generic/_sisu/image b/data/samples/generic/_sisu/image
new file mode 120000
index 0000000..e54c502
--- /dev/null
+++ b/data/samples/generic/_sisu/image
@@ -0,0 +1 @@
+../../../image
+\ No newline at end of file