aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
-rw-r--r--conf/sisu/v2/sisurc.yml63
-rw-r--r--conf/sisu/v3/sisurc.yml78
-rw-r--r--data/doc/sisu/CHANGELOG_v22
-rw-r--r--data/doc/sisu/CHANGELOG_v32
-rw-r--r--data/doc/sisu/markup-samples/sisu_manual/_sisu/sisurc.yml172
-rw-r--r--data/doc/sisu/markup-samples/sisu_manual/_sisu/v2/sisurc.yml132
-rw-r--r--data/doc/sisu/markup-samples/sisu_manual/_sisu/v3/sisurc.yml137
7 files changed, 342 insertions, 244 deletions
diff --git a/conf/sisu/v2/sisurc.yml b/conf/sisu/v2/sisurc.yml
index 982274d1..1b1437f4 100644
--- a/conf/sisu/v2/sisurc.yml
+++ b/conf/sisu/v2/sisurc.yml
@@ -30,10 +30,12 @@
# base_path: ~
# port: '8081'
# user: ~
+
show_output_on: 'filesystem_url'
#texinfo display output
#texinfo:
# stub: 'texinfo'
+
##% processing directories, main path and subdirectories (appended to $HOME), using defaults set in sysenv
#processing:
# path: '~'
@@ -43,16 +45,18 @@ show_output_on: 'filesystem_url'
# 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: '-NhwepoabxXyYv' # -m run by default; includes verbose
- i: '-hwpoay' # -m run by default
- ii: '-NhwepoabxXy' # -m run by default
- iii: '-NhwepoabxXyY' # -m run by default
- iv: '-NhwepoabxXYDy --update' # -m run by default
- v: '-NhwepoabxXYDyv --update' # -m run by default; includes verbose
+ default: '-NhewpotbxXyYv' # -m run by default; includes verbose
+ i: '-Nhewpoty' # -m run by default
+ ii: '-NhewpotbxX' # -m run by default
+ iii: '-NhewpotbxXY' # -m run by default
+ iv: '-NhwepoabxXYD --update' # -m run by default
+ v: '-NhewpotbxXYDv --update' # -m run by default; includes verbose
#% papersize, (LaTeX/pdf) available values: A4, US_letter, book_b5, book_a5, US_legal
+
default:
papersize: 'A4,letter'
#texpdf_font: 'Liberation Serif' # 'Liberation Sans' 'Liberation Serif'
@@ -62,7 +66,9 @@ default:
#multilingual: false
#language_file: 2
#language: 'English'
+
#% markup, make *{emphasis}* 'bold' or 'italics', default if not configured is 'bold'
+
#% settings used by ssh scp
#remote:
# -
@@ -73,9 +79,11 @@ default:
# user: '[usrname]'
# host: '[remote.hostname]'
# path: '.' #no trailing slash eg 'sisu/www'
+
#% webrick information
#webrick:
# port: '8081'
+
#% sql database info, postgresql and sqlite
#db:
# share_source: false # boolean, default is false
@@ -90,14 +98,12 @@ default:
#html:
# quick_ref: true #default false
# seg_title_banner: true #default false
-#% 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: false
css_modify: false
# remote_base_site: true
+
program_set:
rmagick: false
# wc: true
@@ -107,25 +113,24 @@ program_set:
# tidy: true
# rexml: true
# pdflatex: true
+
#program_select:
-# editor: 'gvim -c :R -c :S'
-# pdf_viewer: 'evince'
-# web_browser: 'firefox' #'iceweasel' #'epiphany' #'galeon' #'konqueror' #'kazehakase'
-# console_www_browser: 'links2' #'elinks' #'w3m' #'lynx' #'links'
-# epub_viewer: 'ebook-viewer' #'calibre' #'okular' #'fbreader'
-# odf_viewer: 'oowriter' #'abiword'
-# xml_viewer: 'xml-viewer'
-# man: 'nroff -man' #'groff -man -Tascii' # 'nroff -man'
-#promo: sisu_icon, sisu, sisu_search_libre, open_society, fsf, ruby
+# editor: 'vim'
+# pdf_viewer: 'evince'
+# web_browser: 'iceweasel'
+# console_web_browser: 'links2' #'elinks' #'w3m' #'lynx' #'links'
+# odf_viewer: 'lowriter' #'oowriter' #'abiword'
+# xml_viewer: 'xml-viewer'
+# epub_viewer: 'ebook-viewer' #'calibre' #'fbreader' #'okular'
+# info_viewer: 'pinfo -f'
+# man: 'man' #'groff -man -Tascii' # 'nroff -man'
+
#search:
# sisu:
-# flag: true
-## action: http://localhost:8081/cgi-bin/sisu_pgsql.cgi
-# action: http://search.sisudoc.org
-# db: sisu
-# title: sample search form
-# hyperestraier:
-# flag: true
-# action: http://search.sisudoc.org/cgi-bin/estseek.cgi?
-#manifest:
-# minitoc: true
+# flag: true
+## action: http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+# action: http://search.sisudoc.org
+# db: sisu
+# title: sample search form
+
+#promo: sisu_search_libre, sisu_icon, sisu, open_society, fsf, ruby
diff --git a/conf/sisu/v3/sisurc.yml b/conf/sisu/v3/sisurc.yml
index f250b71d..f5473c79 100644
--- a/conf/sisu/v3/sisurc.yml
+++ b/conf/sisu/v3/sisurc.yml
@@ -30,10 +30,12 @@
# base_path: ~
# port: '8081'
# user: ~
+
show_output_on: 'filesystem_url'
#texinfo display output
#texinfo:
# stub: 'texinfo'
+
##% processing directories, main path and subdirectories (appended to $HOME), using defaults set in sysenv
#processing:
# path: '~'
@@ -43,15 +45,17 @@ show_output_on: 'filesystem_url'
# 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: '-NhwepoabxXyYv' # -m run by default; includes verbose
- i: '-hwpoay' # -m run by default
- ii: '-NhwepoabxXy' # -m run by default
- iii: '-NhwepoabxXyY' # -m run by default
- iv: '-NhwepoabxXYDy --update' # -m run by default
- v: '-NhwepoabxXYDyv --update' # -m run by default; includes verbose
+ default: '-NhewpotbxXyYv' # -m run by default; includes verbose
+ i: '-Nhewpoty' # -m run by default
+ ii: '-NhewpotbxX' # -m run by default
+ iii: '-NhewpotbxXY' # -m run by default
+ iv: '-NhewpotbxXiIY' # -m run by default
+ v: '-NhewpotbxXYDv --update' # -m run by default; includes verbose
+
#% papersize, (LaTeX/pdf) available values: A4, US_letter, book_b5, book_a5, US_legal
default:
papersize: 'A4,letter'
@@ -63,6 +67,7 @@ default:
#language_file: 2
#language: 'English'
#% markup, make *{emphasis}* 'bold' or 'italics', default if not configured is 'bold'
+
#% settings used by ssh scp
#remote:
# -
@@ -73,9 +78,11 @@ default:
# user: '[usrname]'
# host: '[remote.hostname]'
# path: '.' #no trailing slash eg 'sisu/www'
+
#% webrick information
#webrick:
# port: '8081'
+
#% sql database info, postgresql and sqlite
#db:
# share_source: false # boolean, default is false
@@ -87,6 +94,7 @@ default:
# sqlite:
# path: ~ # './sisu_sqlite.db'
# port: "**"
+
#html:
# quick_ref: true #default false
# seg_title_banner: true #default false
@@ -96,30 +104,15 @@ default:
# ocn: true
#% 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
-##% output_strucure: by_language: and/or by_filetype: (else default "bundled"
-##output) possible values ~, true, false, (default where not set, false),
-##output_structure: by_language: (language code directories with filetype
-##subdirectories); by_filetype: (filetype directories output_structure) the
-##previous default was by_language: false by_filetype: false. Note that where
-##by_language is true, by_filetype is (forced) true. If e.g. using po4a
-##by_langauge should be used and set true:
-#output_structure:
-# by_language: true
-# by_filetype: true
-
-#% 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: false
css_modify: false
# remote_base_site: true
+
program_set:
rmagick: false
# wc: true
@@ -129,25 +122,24 @@ program_set:
# tidy: true
# rexml: true
# pdflatex: true
+
#program_select:
-# editor: 'gvim -c :R -c :S'
-# pdf_viewer: 'evince'
-# web_browser: 'firefox' #'iceweasel' #'epiphany' #'galeon' #'konqueror' #'kazehakase'
-# console_www_browser: 'links2' #'elinks' #'w3m' #'lynx' #'links'
-# epub_viewer: 'ebook-viewer' #'calibre' #'okular' #'fbreader'
-# odf_viewer: 'libreoffice' #'oowriter' #'abiword'
-# xml_viewer: 'xml-viewer'
-# man: 'nroff -man' #'groff -man -Tascii' # 'nroff -man'
-#promo: sisu_icon, sisu, sisu_search_libre, open_society, fsf, ruby
+# editor: 'vim'
+# pdf_viewer: 'evince'
+# web_browser: 'iceweasel'
+# console_web_browser: 'links2' #'elinks' #'w3m' #'lynx' #'links'
+# odf_viewer: 'lowriter' #'oowriter' #'abiword'
+# xml_viewer: 'xml-viewer'
+# epub_viewer: 'ebook-viewer' #'calibre' #'fbreader' #'okular'
+# info_viewer: 'pinfo -f'
+# man: 'man' #'groff -man -Tascii' # 'nroff -man'
+
#search:
# sisu:
-# flag: true
-## action: http://localhost:8081/cgi-bin/sisu_pgsql.cgi
-# action: http://search.sisudoc.org
-# db: sisu
-# title: sample search form
-# hyperestraier:
-# flag: true
-# action: http://search.sisudoc.org/cgi-bin/estseek.cgi?
-#manifest:
-# minitoc: true
+# flag: true
+## action: http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+# action: http://search.sisudoc.org
+# db: sisu
+# title: sample search form
+
+#promo: sisu_search_libre, sisu_icon, sisu, open_society, fsf, ruby
diff --git a/data/doc/sisu/CHANGELOG_v2 b/data/doc/sisu/CHANGELOG_v2
index 08ecd407..03611430 100644
--- a/data/doc/sisu/CHANGELOG_v2
+++ b/data/doc/sisu/CHANGELOG_v2
@@ -26,6 +26,8 @@ http://git.sisudoc.org/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/3.0.13-1
* define \hardspace to simplify placing a hardspace (within a code block)
* provide backslash character in code block
+ * sisurc.yml, config settings
+
%% 2.9.6.orig.tar.gz (2011-06-07:23/2) [see 3.0.12]
http://git.sisudoc.org/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/3.0.12-1
diff --git a/data/doc/sisu/CHANGELOG_v3 b/data/doc/sisu/CHANGELOG_v3
index 67708e7c..8984a2ef 100644
--- a/data/doc/sisu/CHANGELOG_v3
+++ b/data/doc/sisu/CHANGELOG_v3
@@ -28,6 +28,8 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.13.orig.tar.gz
* ok for plaintext, html, xhtml, xml, epub, pdf, manpage
* not properly honored in paragraph objects for odt [todo fix, but issue]
+ * sisurc.yml, config settings
+
* vim
* sisu syntax highlighting, linebreak \\ added (<br> kept)
* colors, added cursor line & column
diff --git a/data/doc/sisu/markup-samples/sisu_manual/_sisu/sisurc.yml b/data/doc/sisu/markup-samples/sisu_manual/_sisu/sisurc.yml
deleted file mode 100644
index 2b3df4db..00000000
--- a/data/doc/sisu/markup-samples/sisu_manual/_sisu/sisurc.yml
+++ /dev/null
@@ -1,172 +0,0 @@
-# Name: SiSU - Simple information Structuring Universe
-# Author: Ralph@Amissah.com
-# Description: Site wide envionment 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
-# $Date$
-# $Id$
-# Notes: implemented 2004w03
-# Site environment configuration file
-# this file should be configured and live in
-# /etc/sisu #per environment settings, overridden by:
-# ~/.sisu #per user settings, overridden by:
-# ./_sisu #per local markup directory settings
-#% #image source directory, main path and subdirectories
-#image:
-## path: 'grotto/theatre/working'
-# path: 'sisu_working'
-# public: 'sisu_image'
-# #all: 'image'
-#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
-webserv:
- url_root: 'http://www.jus.uio.no' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
- path: '/var/www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
- #images: 'sisu/image'
- #man: 'man'
- #php: 'php'
- #cgi: '/usr/local/lib/sisu-cgi'
- feed: 'feed'
- sqlite: 'sisu/sqlite'
-# webrick_url: true
-#show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
-#show_output_on: 'local:8111'
-webserv_cgi:
-# host: localhost
-# base_path: ~
-# port: '8081'
-# user: ~
- file_links: webserv
-# file_links: www.jus.uio.no
-show_output_on: 'filesystem_url'
-#texinfo display output
-#texinfo:
-# stub: 'texinfo'
-#% processing directories, main path and subdirectories
-processing:
-# path: '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: '-NhewpoabxXyYv' # includes verbose; -m would in any event be run by default
- i: '-Nhewpoayv' # includes verbose; -m run by default
- ii: '-NhewpoabxXyv' # includes verbose; -m run by default
- iii: '-NhewpoabxXyYv' # includes verbose; -m run by default
- iv: '-NhewpoabxXYDyv --import' # includes verbose; -m run by default
- v: '-NhewpoabxXYDyv --update' # includes verbose; -m run by default
-#flag:
-# color: false # colour off default -c is toggle, and will toggle colour on
-# i: '-mhwpcyv' # adding colour and verbosity to defaults (note: another -c won't toggle off)
-# ii: '-mhwpaocyv' # adding colour and verbosity to defaults (note: another -c won't toggle off)
-# iii: '-mhwpaobxXcyv' # adding colour and verbosity to defaults (note: another -c won't toggle off)
-# iv: '-mhwpaobxXDcyv --import' # adding colour and verbosity to defaults (note: another -c won't toggle off)
-# v: '-mhwpaobxXDcyv --update' # adding colour and verbosity to defaults (note: another -c won't toggle off)
-#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
-default:
- #papersize: 'a4,letter'
- papersize: 'A4'
- language_file: 2
- #digest: 'sha' #sha is sha256, default is md5
- #multilingual: false
- #language: 'English'
-#% settings used by ssh scp
-remote:
- user: 'ralpha'
- host: 'ulrik.uio.no'
- #host: 'klodrik.uio.no'
- path: '.' #no trailing slash eg 'sisu/www'
-#% webrick information
-#sql database info, postgresql and sqlite
-db:
- postgresql:
- port: '5432' # '5432'
- #user: 'tst' # '[provide username]'
- #host: 'sisudoc.org'
- #password: 'alternate1'
- #user: 'ralph'
- ##port: '5433'
- #port: '5432'
- sqlite:
- user: 'ralph'
- path: ~ # './sisu_sqlite.db'
- port: "**"
- multi: true
-# single: true
-#% 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: 'gvim -c :R'
- pdf_viewer: 'evince'
- web_browser: 'kazehakase'
- console_web_browser: 'links2'
- odf_viewer: 'oowriter'
- xml_viewer: 'xml-viewer'
-search:
- sisu:
- flag: true
-# action: http://localhost:8081/cgi-bin/sisu_pgsql.cgi
- action: http://search.sisudoc.org
- db: sisu
- title: sample search form
- hyperestraier:
- flag: true
- action: http://search.sisudoc.org/cgi-bin/estseek.cgi?
-promo: sisu_search_libre, sisu_icon, sisu, open_society, fsf, ruby
-#promo: sisu_search_libre, ad, sisu_icon, sisu, open_society, fsf, ruby
-#promo: ad, sisu_icon, sisu, sisu_search_libre, open_society, fsf, ruby
-## on (unless file says off); off (unless file says on); off regardless of file status
-#promo:
-# default_status: true
-# switch_off: false
-# list:
-# ad:
-# adsense:
-# sisu:
-# site:
-# - sisu
-# open_society:
-# site:
-# - twon
-# - fc
-# - faif
-# - twobits
-# # - ffa
-# - catb
-# sisu_icon:
-# site:
-# - sisu_icon
-# ruby:
-# site:
-# - ruby_logo
-# fsf:
-# site:
-# - fsf
-# gpl:
-# site:
-# - gpl
-# sisu_search_libre:
-# search:
-# - sisu_books_libre_sisusearch
diff --git a/data/doc/sisu/markup-samples/sisu_manual/_sisu/v2/sisurc.yml b/data/doc/sisu/markup-samples/sisu_manual/_sisu/v2/sisurc.yml
new file mode 100644
index 00000000..433c6967
--- /dev/null
+++ b/data/doc/sisu/markup-samples/sisu_manual/_sisu/v2/sisurc.yml
@@ -0,0 +1,132 @@
+# Name: SiSU - Simple information Structuring Universe
+# Author: Ralph@Amissah.com
+# Description: Site wide envionment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+# site environment configuration file
+# this file should be configured and live in
+# /etc/sisu #per environment settings, overridden by:
+# ~/.sisu #per user settings, overridden by:
+# ./_sisu #per local markup directory settings
+#% #image source directory, main path and subdirectories
+#image:
+# path: 'sisu_working'
+# public: '_sisu/image'
+# #all: 'image'
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+#webserv:
+# url_root: 'http://www.your.url' #without dir stub
+# path: '/var/www' #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'
+# feed: 'feed'
+# sqlite: 'sisu/sqlite'
+# webrick_url: true
+#show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+#show_output_on: 'local:8111'
+#webserv_cgi:
+# host: localhost
+# base_path: ~
+# port: '8081'
+# user: ~
+# file_links: webserv
+
+show_output_on: 'filesystem_url'
+#texinfo display output
+#texinfo:
+# stub: 'texinfo'
+
+#% processing directories, main path and subdirectories
+#processing:
+# path: '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: '-NhewpotbxXyYv' # -m run by default; includes verbose
+ i: '-Nhewpoty' # -m run by default
+ ii: '-NhewpotbxX' # -m run by default
+ iii: '-NhewpotbxXY' # -m run by default
+ iv: '-NhewpotbxXiIY' # -m run by default
+ v: '-NhewpotbxXYDv --update' # -m run by default; includes verbose
+
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+ papersize: 'a4,letter'
+ language_file: 2
+ #digest: 'sha' #sha is sha256, default is md5
+ #language: 'English'
+ #emphasis: 'italics'
+
+#% settings used by ssh scp
+#remote:
+# -
+# user: '[usrname]'
+# host: '[remote.hostname]'
+# path: '.' #no trailing slash eg 'sisu/www'
+# -
+# user: '[usrname]'
+# host: '[remote.hostname]'
+# path: '.' #no trailing slash eg 'sisu/www'
+
+#% webrick information
+#webrick:
+# port: '8081'
+
+#sql database info, postgresql and sqlite
+db:
+ postgresql:
+ port: '5432' # '5432'
+ #user: 'tst' # '[provide username]'
+ #host: 'sisudoc.org'
+ #user: 'ralph'
+ ##port: '5433'
+ #port: '5432'
+ sqlite:
+ user: 'ralph'
+ path: ~ # './sisu_sqlite.db'
+ port: "**"
+ multi: true
+# single: true
+
+permission_set:
+ zap: true
+ css_modify: true
+ remote_base_site: true
+
+program_set:
+ rmagick: false
+# wc: true
+# editor: true
+# postgresql: true
+# sqlite: true
+# tidy: true
+# rexml: true
+# pdflatex: true
+
+#program_select:
+# editor: 'vim'
+# pdf_viewer: 'evince'
+# web_browser: 'iceweasel'
+# console_web_browser: 'links2' #'elinks' #'w3m' #'lynx' #'links'
+# odf_viewer: 'lowriter' #'oowriter' #'abiword'
+# xml_viewer: 'xml-viewer'
+# epub_viewer: 'ebook-viewer' #'calibre' #'fbreader' #'okular'
+# info_viewer: 'pinfo -f'
+# man: 'man' #'groff -man -Tascii' # 'nroff -man'
+
+#search:
+# sisu:
+# flag: true
+## action: http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+# action: http://search.sisudoc.org
+# db: sisu
+# title: sample search form
+
+#promo: sisu_search_libre, sisu_icon, sisu, open_society, fsf, ruby
diff --git a/data/doc/sisu/markup-samples/sisu_manual/_sisu/v3/sisurc.yml b/data/doc/sisu/markup-samples/sisu_manual/_sisu/v3/sisurc.yml
new file mode 100644
index 00000000..ed452402
--- /dev/null
+++ b/data/doc/sisu/markup-samples/sisu_manual/_sisu/v3/sisurc.yml
@@ -0,0 +1,137 @@
+# Name: SiSU - Simple information Structuring Universe
+# Author: Ralph@Amissah.com
+# Description: Site wide envionment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+# site environment configuration file
+# this file should be configured and live in
+# /etc/sisu #per environment settings, overridden by:
+# ~/.sisu #per user settings, overridden by:
+# ./_sisu #per local markup directory settings
+#% #image source directory, main path and subdirectories
+#image:
+# path: 'sisu_working'
+# public: '_sisu/image'
+# #all: 'image'
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+#webserv:
+# url_root: 'http://www.your.url' #without dir stub
+# path: '/var/www' #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'
+# feed: 'feed'
+# sqlite: 'sisu/sqlite'
+# webrick_url: true
+#show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+#show_output_on: 'local:8111'
+#webserv_cgi:
+# host: localhost
+# base_path: ~
+# port: '8081'
+# user: ~
+# file_links: webserv
+
+show_output_on: 'filesystem_url'
+#texinfo display output
+#texinfo:
+# stub: 'texinfo'
+
+#% processing directories, main path and subdirectories
+#processing:
+# path: '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: '-NhewpotbxXyYv' # -m run by default; includes verbose
+ i: '-Nhewpoty' # -m run by default
+ ii: '-NhewpotbxX' # -m run by default
+ iii: '-NhewpotbxXY' # -m run by default
+ iv: '-NhewpotbxXiIY' # -m run by default
+ v: '-NhewpotbxXYDv --update' # -m run by default; includes verbose
+
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal, easily extensible
+default:
+ papersize: 'a4,letter'
+ language_file: 2
+ #digest: 'sha' #sha is sha256, default is md5
+ #language: 'English'
+ #emphasis: 'italics'
+
+#% settings used by ssh scp
+#remote:
+# -
+# user: '[usrname]'
+# host: '[remote.hostname]'
+# path: '.' #no trailing slash eg 'sisu/www'
+# -
+# user: '[usrname]'
+# host: '[remote.hostname]'
+# path: '.' #no trailing slash eg 'sisu/www'
+
+#% webrick information
+#webrick:
+# port: '8081'
+
+#sql database info, postgresql and sqlite
+db:
+ postgresql:
+ port: '5432' # '5432'
+ #user: 'tst' # '[provide username]'
+ #host: 'sisudoc.org'
+ #user: 'ralph'
+ ##port: '5433'
+ #port: '5432'
+ sqlite:
+ user: 'ralph'
+ path: ~ # './sisu_sqlite.db'
+ port: "**"
+ multi: true
+# single: true
+
+#% 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
+
+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'
+# pdf_viewer: 'evince'
+# web_browser: 'iceweasel'
+# console_web_browser: 'links2' #'elinks' #'w3m' #'lynx' #'links'
+# odf_viewer: 'lowriter' #'oowriter' #'abiword'
+# xml_viewer: 'xml-viewer'
+# epub_viewer: 'ebook-viewer' #'calibre' #'fbreader' #'okular'
+# info_viewer: 'pinfo -f'
+# man: 'man' #'groff -man -Tascii' # 'nroff -man'
+
+#search:
+# sisu:
+# flag: true
+## action: http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+# action: http://search.sisudoc.org
+# db: sisu
+# title: sample search form
+
+#promo: sisu_search_libre, sisu_icon, sisu, open_society, fsf, ruby