sisu 7.0.0

data/lib/sisu/ao_character_check.rb

@@ -0,0 +1,102 @@
+# encoding: utf-8
+=begin
+
+* Name: SiSU
+
+** Description: documents, structuring, processing, publishing, search
+*** system environment, resource control and configuration details
+
+** Author: Ralph Amissah
+  <ralph@amissah.com>
+  <ralph.amissah@gmail.com>
+
+** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Ralph Amissah,
+  All Rights Reserved.
+
+** License: GPL 3 or later:
+
+  SiSU, a framework for document structuring, publishing and search
+
+  Copyright (C) Ralph Amissah
+
+  This program is free software: you can redistribute it and/or modify it
+  under the terms of the GNU General Public License as published by the Free
+  Software Foundation, either version 3 of the License, or (at your option)
+  any later version.
+
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+  more details.
+
+  You should have received a copy of the GNU General Public License along with
+  this program. If not, see <http://www.gnu.org/licenses/>.
+
+  If you have Internet connection, the latest version of the GPL should be
+  available at these locations:
+  <http://www.fsf.org/licensing/licenses/gpl.html>
+  <http://www.gnu.org/licenses/gpl.html>
+
+  <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+
+** SiSU uses:
+  * Standard SiSU markup syntax,
+  * Standard SiSU meta-markup syntax, and the
+  * Standard SiSU object citation numbering and system
+
+** Hompages:
+  <http://www.jus.uio.no/sisu>
+  <http://www.sisudoc.org>
+
+** Git
+  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary>
+  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_character_check.rb;hb=HEAD>
+
+=end
+module SiSU_AO_CharacterCheck
+  class Check
+    def initialize(data)
+      @data=data
+      @comment='%'
+      @endnote_array=[]
+    end
+    def character_check_and_oldstyle_endnote_array
+      data=@data
+      @endnote_array=[]
+      endnote_no=1
+      @tuned_file=data.select do |dob|
+        unless dob.is ==:table
+          dob.obj=dob.obj.strip.
+            gsub(/^[{~}]\s*$/,'').
+            gsub(/~#\s*/,"#{Mx[:pa_non_object_no_heading]}").
+            gsub(/-#\s*/,"#{Mx[:pa_non_object_dummy_heading]}").
+            gsub(/(#{Mx[:en_a_o]})\s*\s+/,'\1 ').
+            gsub(/(~\{\s*)\s+/,'\1 ').
+            gsub(/ \/\//,"#{Mx[:br_line]}").
+            gsub(/<br>/,"#{Mx[:br_line]}").                #needed by xml, xhtml etc.
+            gsub(/\t/,' ').
+            gsub(/\342\200\231/u,"'"). #if dob =~/’/       #Avoid #&lsquo; &rsquo; #&ldquo; &rdquo;
+            gsub(/\\copy(?:right)?\b/,'&#169;').
+            gsub(/\\trademark\b|\\tm\b/,'&#174;')
+          dob.obj=dob.obj + "\n"
+          unless dob.is ==:code
+            case dob.obj
+            when /\^~/                                     #% Note must do this first (earlier loop) and then enter gathered data into ~^\d+
+              sub_dob=dob.obj.dup
+              @endnote_array << sub_dob.gsub(/\n/,'').
+                gsub(/\^~\s+(.+)\s*/,
+                  %{#{Mx[:en_a_o]}#{endnote_no} \\1 #{Mx[:en_a_c]}}).
+                  strip
+              endnote_no+=1
+              dob=nil if dob.obj =~/\^~ .+/                #watch, removes 'binary' endnote now in endnote array for later insertion
+            end
+          end
+        end
+        dob if dob.is_a?(Object)
+      end.flatten.compact
+      [@tuned_file,@endnote_array]
+    end
+  end
+end
+__END__

data/lib/sisu/ao_composite.rb

@@ -0,0 +1,286 @@
+# encoding: utf-8
+=begin
+
+* Name: SiSU
+
+** Description: documents, structuring, processing, publishing, search
+*** composite documents, assemble/build documents from other documents
+  or parts of marked up text
+
+** Author: Ralph Amissah
+  <ralph@amissah.com>
+  <ralph.amissah@gmail.com>
+
+** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Ralph Amissah,
+  All Rights Reserved.
+
+** License: GPL 3 or later:
+
+  SiSU, a framework for document structuring, publishing and search
+
+  Copyright (C) Ralph Amissah
+
+  This program is free software: you can redistribute it and/or modify it
+  under the terms of the GNU General Public License as published by the Free
+  Software Foundation, either version 3 of the License, or (at your option)
+  any later version.
+
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+  more details.
+
+  You should have received a copy of the GNU General Public License along with
+  this program. If not, see <http://www.gnu.org/licenses/>.
+
+  If you have Internet connection, the latest version of the GPL should be
+  available at these locations:
+  <http://www.fsf.org/licensing/licenses/gpl.html>
+  <http://www.gnu.org/licenses/gpl.html>
+
+  <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+
+** SiSU uses:
+  * Standard SiSU markup syntax,
+  * Standard SiSU meta-markup syntax, and the
+  * Standard SiSU object citation numbering and system
+
+** Hompages:
+  <http://www.jus.uio.no/sisu>
+  <http://www.sisudoc.org>
+
+** Git
+  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary>
+  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_composite.rb;hb=HEAD>
+
+=end
+module SiSU_Assemble
+  require_relative 'se'                                 # se.rb
+  require_relative 'utils_composite'                    # utils_composite.rb
+  class RemoteImage
+    def initialize
+      @env=SiSU_Env::InfoEnv.new
+    end
+    def image(dir)
+      images=[]
+      images[0]=dir
+      images
+    end
+    def download_images(images_info)
+      path="#{@env.processing_path.processing}/external_document/image"
+      FileUtils::mkdir_p(path) \
+        unless FileTest.directory?(path)
+      download_from=images_info.shift
+      images_info.each do |i|
+        image="#{path}/#{i}"
+        imagefile=File.new(image,'w+')
+        open("#{download_from}/#{i}") do |g|
+          imagefile << g.read
+        end
+        imagefile.close
+      end
+      output_path="#{@env.path.webserv}/#{@env.path.base_markup_dir_stub}/_sisu/image_external"
+      FileUtils::mkdir_p(output_path) \
+        unless FileTest.directory?(output_path)
+      SiSU_Env::SystemCall.new("#{path}/*",output_path,'q').rsync
+    end
+  end
+  class Composite
+    include SiSU_Composite_Doc_Utils # composite doc, .ssm, extract all related insert files, array of filenames test
+    def initialize(opt)
+      @opt=opt
+      @env=SiSU_Env::InfoEnv.new
+    end
+    def read
+      begin
+        pwd=Dir.pwd
+        Dir.chdir(@opt.f_pth[:pth])
+        if @opt.fno =~/\S+?\.ssm$/
+          SiSU_Screen::Ansi.new(
+            @opt.act[:color_state][:set],
+            'Composite Document',
+            "[#{@opt.f_pth[:lng_is]}] #{@opt.fno}",
+          ).grey_title_hi unless @opt.act[:quiet][:set]==:on
+          composite_and_imported_filenames_array(@opt.fno) # composite doc, .ssm, extract all related insert files, array of filenames test
+          assembled=loadfile(@opt.fno)
+          write(assembled)
+        end
+        Dir.chdir(pwd)
+      rescue
+        SiSU_Errors::Rescued.new($!,$@,@opt.selections.str,@opt.fns).
+          location do
+          __LINE__.to_s + ':' + __FILE__
+        end
+      ensure
+      end
+    end
+    def insert?(para)
+      if para =~ /^<<\s+((?:https?|file):\/\/\S+?\.ss[it])$/ # and NetTest
+        url($1.strip)
+      elsif para =~/^<<\s+(\S+?\.ss[it])$/
+        loadfilename=$1.strip
+        insert_array=loadfile(loadfilename)
+        file=insertion(loadfilename,insert_array)
+        file[:prepared]
+      else para
+      end
+    end
+    def loadfile(loadfilename)
+      begin
+        if FileTest.file?(loadfilename)
+          insert_array=IO.readlines(loadfilename,'')
+          if loadfilename =~/\S+?\.ss[itm]$/
+            if (@opt.act[:verbose][:set]==:on \
+            || @opt.act[:verbose_plus][:set]==:on \
+            || @opt.act[:maintenance][:set]==:on)
+              SiSU_Screen::Ansi.new(
+                @opt.act[:color_state][:set],
+                'loading:',
+                loadfilename,
+              ).txt_grey
+            end
+            tuned_file=if loadfilename =~/\S+?\.ss[im]$/
+              insert_array.each.map do |para|
+                insert?(para)
+              end
+            elsif loadfilename =~/\S+?\.sst$/
+              insert_array.each.map do |para|
+                para
+              end
+            end.flatten.compact
+          end
+        end
+      rescue
+        SiSU_Errors::Rescued.new($!,$@,@opt.selections.str,@opt.fns).location do
+          __LINE__.to_s + ':' + __FILE__
+        end
+      ensure
+      end
+    end
+    def url(loadfilename)
+      if loadfilename =~ /((?:https?|file):\/\/\S+?\.ss[it])$/ # and NetTest
+        loadfilename=$1
+        begin
+          require 'uri'
+          require 'open-uri'
+          require 'pp'
+        rescue LoadError
+          SiSU_Utils::CodeMarker.new(__LINE__,__FILE__,:fuchsia).
+            error('uri, open-uri or pp NOT FOUND (LoadError)')
+        end
+        insert=open(loadfilename)
+        insert_array=insert.dup
+        insert.close
+        file=insertion(loadfilename,insert_array)
+        file[:prepared]
+      end
+    end
+    def write(assembled)
+      assembled_file=File.new("#{@env.processing_path.composite_file}/#{@opt.fnb}.ssm.sst",'w+')
+      assembled.each {|a| assembled_file << a }
+      assembled_file.close
+    end
+    def download_images(download_from,images_array)
+      path="#{@env.processing_path.processing}/external_document/image"
+      FileUtils::mkdir_p(path) unless FileTest.directory?(path)
+      images_array.each do |i|
+        image="#{path}/#{i}"
+        unless FileTest.exists?(image)
+          imagefile=File.new(image,'w+')
+          open("#{download_from}/#{i}") do |g|
+            imagefile << g.read
+          end
+          imagefile.close
+        end
+      end
+    end
+    def insertion(fni,insert_array)
+      file={ prepared: [], images: [] }
+      rgx_image=/(?:^|[^_\\])\{\s*(\S+?\.(?:png|jpg|gif))/
+      file[:prepared] << "\n% |#{fni}|@|^|>>ok\n\n"
+      @code_flag=false
+      insert_array.each do |i|
+        @code_flag=if i =~/^code\{/ then true
+        elsif i =~/^\}code/         then false
+        else @code_flag
+        end
+        if not @code_flag \
+        and i !~/^%+\s/
+          i=i.
+            gsub(/^([123]|:?[ABCD])~\? /,
+              '% [conditional heading:] \1~ ')    #off conditional heading (consider syntax)
+          if i =~/^@\S+?:/
+            i=i.gsub(/\n/m,"\n%  ").
+              gsub(/\n%\s+$/m,'').
+              gsub(/^@\S+?:/m,"\n% [imported header:] ")                       #off imported headers
+          end
+        end
+        file[:prepared] << i
+        if i !~/^%+\s/ \
+        and i =~rgx_image
+          file[:images] << i.scan(rgx_image).uniq
+        end
+      end
+      file[:prepared] << "\n% end import" << "\n\n"
+      if file[:images].length > 0
+        file[:images]=file[:images].flatten.uniq
+        file[:images].delete_if {|x| x =~/https?:\/\// }
+      end
+      file
+    end
+  end
+  class CompositeFileList
+    def initialize(opt)
+      @opt=opt
+      @env=SiSU_Env::InfoEnv.new
+    end
+    def read
+      begin
+        @opt.fns=@opt.fns.gsub(/\.ssm\.sst$/,'.ssm') #FIX earlier, hub
+        fns_array=IO.readlines(@opt.fns,'')
+        insertions?(fns_array)
+      rescue
+        SiSU_Errors::Rescued.new($!,$@,@opt.selections.str,@opt.fns).location do
+          __LINE__.to_s + ':' + __FILE__
+        end
+      ensure
+      end
+    end
+    def insertions?(fns_array)
+      tuned_file=[]
+      SiSU_Screen::Ansi.new(
+        @opt.act[:color_state][:set],
+        'Composite Document',
+        @opt.fno
+      ).grey_title_hi unless @opt.act[:quiet][:set]==:on
+      @ssm=[@opt.fns]
+      fns_array.each do |para|
+        if para =~/^<<\s+(\S+?\.ss[it])$/
+          loadfilename=$1.strip
+          if (@opt.act[:verbose][:set]==:on \
+          || @opt.act[:verbose_plus][:set]==:on \
+          || @opt.act[:maintenance][:set]==:on)
+            SiSU_Screen::Ansi.new(
+              @opt.act[:color_state][:set],
+              'loading:',
+              loadfilename,
+            ).txt_grey
+          end
+          tuned_file << if loadfilename =~ /(?:https?|file):\/\/\S+?\.ss[it]$/
+            @ssm << loadfilename
+          elsif loadfilename =~ /\.ss[it]$/ \
+          and FileTest.file?(loadfilename)
+            @ssm << loadfilename
+          else
+            STDERR.puts %{SKIPPED processing file: [#{@opt.lng}] "#{@opt.fns}" it requires an invalid or non-existent file: "#{loadfilename}"}
+            $process_document = :skip; break #remove this line to continue processing documents that have missing include files
+            para
+          end
+        end
+      end
+      @ssm
+    end
+  end
+end
+__END__

data/lib/sisu/ao_doc_objects.rb

@@ -0,0 +1,565 @@
+# encoding: utf-8
+=begin
+
+* Name: SiSU
+
+** Description: documents, structuring, processing, publishing, search
+*** document abstraction
+
+** Author: Ralph Amissah
+  <ralph@amissah.com>
+  <ralph.amissah@gmail.com>
+
+** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Ralph Amissah,
+  All Rights Reserved.
+
+** License: GPL 3 or later:
+
+  SiSU, a framework for document structuring, publishing and search
+
+  Copyright (C) Ralph Amissah
+
+  This program is free software: you can redistribute it and/or modify it
+  under the terms of the GNU General Public License as published by the Free
+  Software Foundation, either version 3 of the License, or (at your option)
+  any later version.
+
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+  more details.
+
+  You should have received a copy of the GNU General Public License along with
+  this program. If not, see <http://www.gnu.org/licenses/>.
+
+  If you have Internet connection, the latest version of the GPL should be
+  available at these locations:
+  <http://www.fsf.org/licensing/licenses/gpl.html>
+  <http://www.gnu.org/licenses/gpl.html>
+
+  <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+
+** SiSU uses:
+  * Standard SiSU markup syntax,
+  * Standard SiSU meta-markup syntax, and the
+  * Standard SiSU object citation numbering and system
+
+** Hompages:
+  <http://www.jus.uio.no/sisu>
+  <http://www.sisudoc.org>
+
+** Git
+  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary>
+  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_doc_objects.rb;hb=HEAD>
+
+=end
+module SiSU_AO_DocumentStructure
+  class Extract
+    def extract(h,o)
+      h ? h : o
+    end
+  end
+  class ObjectMetadata
+    attr_accessor :is,:of,:tags,:obj,:digest
+    def initialize
+      @tags={}
+      @is=@tmp=@digest=nil
+      @of=:meta
+    end
+    def metadata(tags)
+      of      = @of                                                                 #Symbol, classification - group
+      is      = :meta                                                               #Symbol, classification - specific type
+      tags    = tags            || ((defined? o.tags)      ? o.tags        : {})    #String, metadata type/tag
+      obj     = nil
+      @of,@is,@tags,@obj=of,is,tags,obj
+      self
+    end
+  end
+  class ObjectMeta
+    attr_accessor :obj,:is,:of,:tag,:digest,:tmp
+    def initialize
+      @is=@obj=@tag=@digest=@digest=@tmp=nil
+      @of=:meta
+    end
+    def metadata(h,o=nil)
+      of      = @of                                                                 #Symbol, classification - group
+      is      = :meta                                                               #Symbol, classification - specific type
+      tag     = h[:tag]         || ((defined? o.tag)       ? o.tag         : nil)   #String, metadata type/tag
+      obj     = h[:obj]         || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      tmp     = h[:tmp]         || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      digest  = h[:digest]      || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      @of,@is,@tag,@obj,@digest,@tmp=of,is,tag,obj,digest,tmp
+      self
+    end
+  end
+  class ObjectHeading
+    attr_accessor :obj,:is,:tags,:of,:lv,:ln,:lc,:use_,:name,:idx,:ocn,:odv,:osp,:node,:parent,:ocn_,:note_,:autonum_,:digest,:tmp
+    def initialize
+      @of=:para
+      @is=@obj=@lv=@ln=@lc=@use_=@name=@idx=@size=@ocn=@odv=@osp=@node=@parent=@ocn_=@note_=@autonum_=@digest=@tmp=nil
+      @tags=[]
+    end
+    def heading_ln(lv)
+      case lv
+      when /A/ then 0
+      when /B/ then 1
+      when /C/ then 2
+      when /D/ then 3
+      when /1/ then 4
+      when /2/ then 5
+      when /3/ then 6
+      when /4/ then 7
+      when /5/ then 8
+      when /6/ then 9
+      end
+    end
+    def heading_lv(ln)
+      case ln.to_s
+      when /0/ then 'A'
+      when /1/ then 'B'
+      when /2/ then 'C'
+      when /3/ then 'D'
+      when /4/ then '1'
+      when /5/ then '2'
+      when /6/ then '3'
+      when /7/ then '4'
+      when /8/ then '5'
+      when /9/ then '6'
+      end
+    end
+    def heading(h,o=nil)
+      if not h[:ln] \
+      and (h[:lv] and h[:lv]=~/[1-6A-D]/)
+        h[:ln]=heading_ln(h[:lv])
+      elsif not h[:lv] \
+      and (h[:ln] and h[:ln].to_s=~/[0-9]/)
+        h[:lv]=heading_lv(h[:ln])
+      end
+      of      = @of                                                                 #Symbol, classification - group
+      is      = :heading                                                            #Symbol, classification - specific type
+      name    = h[:name]        || ((defined? o.name)      ? o.name        : nil)   #String, named object?
+      tags    = h[:tags]        || ((defined? o.tags)      ? o.tags        : [])    #Array, associated object tags, names if any
+      obj     = h[:obj]         || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      idx     = h[:idx]         || ((defined? o.idx)       ? o.idx         : nil)   #String, book index provided?
+      ocn     = h[:ocn]         || ((defined? o.ocn)       ? o.ocn         : nil)   #Integer, sequential on substantive-content objects
+      odv     = h[:odv]         || ((defined? o.odv)       ? o.odv         : nil)
+      osp     = h[:osp]         || ((defined? o.osp)       ? o.osp         : nil)
+      node    = h[:node]        || ((defined? o.node)      ? o.node        : nil)   #[Node relationship doc structure info]
+      parent  = h[:parent]      || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      lv      = h[:lv]          || ((defined? o.lv)        ? o.lv          : nil)   #Alpha-numeric, document structure as used in markup, A-D then 1-6
+      ln      = h[:ln]          || ((defined? o.ln)        ? o.ln          : nil)   #Integer, document structure level, for convenience in processing 1-9
+      lc      = h[:lc]          || ((defined? o.lc)        ? o.lc          : nil)   #Integer, document structure collapsed level, convenience (collapse sisu's dual level document structure for markup with simple linear structure)
+      use_    = if lv \
+        and lv == '1'
+          h[:use_]              || ((defined? o.use_)      ? o.use_        : :ok)
+        elsif not lv.empty? \
+        and lv =~ /[A-D2-3]/
+          :ok
+        else
+           h[:use_]             || ((defined? o.use_)      ? o.use_        : :ok)
+        end
+      ocn_    = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+        else                       h[:ocn_]
+        end
+      autonum_ = if h[:autonum_].nil?
+                                   ((defined? o.autonum_)  ? o.autonum_    : true)  #Bool? auto-numbering if requested default on, false suppresses
+        else                       h[:autonum_]
+        end
+      note_   = h[:note_]       || ((defined? o.note_)     ? o.note_       : false) #Bool, endnotes/footnotes? (processing optimization)
+      digest  = h[:digest]      || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp     = h[:tmp]         || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@lv,@ln,@lc,@name,@tags,@obj,@idx,@ocn,@odv,@osp,@node,@parent,@use_,@ocn_,@note_,@autonum_,@digest,@tmp=
+      of, is, lv, ln, lc, name, tags, obj, idx, ocn, odv, osp, node, parent, use_, ocn_, note_, autonum_, digest, tmp
+      self
+    end
+    def heading_insert(h,o=nil)
+      heading(h,o=nil)
+      @is     = :heading_insert                                                     #String, classification - specific type
+      self
+    end
+  end
+  class ObjectPara
+    attr_accessor :obj,:is,:tags,:of,:name,:idx,:quote_,:bullet_,:indent,:hang,:ocn,:odv,:osp,:parent,:note_,:image_,:ocn_,:digest,:tmp
+    def initialize
+      @of=:para
+      @is=@obj=@name=@idx=@quote_=@bullet_=@indent=@hang=@size=@ocn=@odv=@osp=@parent=@note_=@image_=@ocn_=@digest=@tmp=nil
+      @tags=[]
+    end
+    def paragraph(h,o=nil)
+      of      = @of                                                                 #Symbol, classification - group
+      is      = :para                                                               #Symbol, classification - specific type
+      name    = h[:name]        || ((defined? o.name)      ? o.name        : nil)   #String, named object?
+      tags    = h[:tags]        || ((defined? o.tags)      ? o.tags        : [])    #Array, associated object tags, names if any
+      obj     = h[:obj]         || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      idx     = h[:idx]         || ((defined? o.idx)       ? o.idx         : nil)   #String, book index provided?
+      ocn     = h[:ocn]         || ((defined? o.ocn)       ? o.ocn         : nil)   #Integer, sequential on substantive-content objects
+      odv     = h[:odv]         || ((defined? o.odv)       ? o.odv         : nil)
+      osp     = h[:osp]         || ((defined? o.osp)       ? o.osp         : nil)
+      parent  = h[:parent]      || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      indent  = h[:indent].to_s || ((defined? o.indent)    ? o.indent.to_s : nil)   #Integer, indent level
+      hang    = h[:hang].to_s   || ((defined? o.hang)      ? o.hang.to_s   : nil)   #Integer, hanging indent level
+      bullet_ = h[:bullet_]     || ((defined? o.bullet_)   ? o.bullet_     : false) #Bool, bulleted?
+      quote_  = h[:quote_]      || ((defined? o.quote_)    ? o.quote_      : false) #Bool, quote (blockquote)?
+      note_   = h[:note_]       || ((defined? o.note_)     ? o.note_       : false) #Bool, endnotes/footnotes? (processing optimization)
+      image_  = h[:image_]      || ((defined? o.image_)    ? o.image_      : false) #Bool, images? (processing optimization)
+      ocn_    = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else         h[:ocn_]
+      end
+      digest  = h[:digest]      || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp     = h[:tmp]         || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@name,@tags,@obj,@indent,@hang,@bullet_,@quote_,@idx,@ocn,@odv,@osp,@parent,@image_,@note_,@ocn_,@digest,@tmp=
+      of, is, name, tags, obj, indent, hang, bullet_, quote_, idx, ocn, odv, osp, parent, image_, note_, ocn_, digest, tmp
+      self
+    end
+    def docinfo(h,o=nil)
+      of      = @of                                                                 #String, classification - group
+      is      = :docinfo                                                            #String, classification - specific type
+      name    = h[:name]        || ((defined? o.name)      ? o.name        : nil)   #String, named object?
+      tags    = h[:tags]        || ((defined? o.tags)      ? o.tags        : nil)   #Array, associated object tags, names if any
+      obj     = h[:obj]         || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      idx     = nil                                                                 #String, book index provided?
+      ocn     = nil                                                                 #Integer, sequential on substantive-content objects
+      odv     = h[:odv]         || ((defined? o.odv)       ? o.odv         : nil)
+      osp     = h[:osp]         || ((defined? o.osp)       ? o.osp         : nil)
+      parent  = h[:parent]      || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      indent  = nil                                                                 #Integer, indent level
+      hang    = nil                                                                 #Integer, indent level
+      bullet_ = false                                                               #Bool, bulleted?
+      note_   = false                                                               #Bool, endnotes/footnotes? (processing optimization)
+      image_  = h[:image_]      || ((defined? o.image_)    ? o.image_      : false) #Bool, images? (processing optimization)
+      ocn_    = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else                         h[:ocn_]
+      end
+      digest  = h[:digest]      || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp     = h[:tmp]         || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@name,@tags,@obj,@indent,@hang,@bullet_,@idx,@ocn,@odv,@osp,@parent,@image_,@note_,@ocn_,@digest,@tmp=
+      of, is, name, tags, obj, indent, hang, bullet_, idx, ocn, odv, osp, parent, image_, note_, ocn_, digest, tmp
+      self
+    end
+  end
+  class ObjectBlockTxt
+    attr_accessor :obj,:is,:of,:tags,:lngsyn,:idx,:ocn,:odv,:osp,:parent,:note_,:number_,:ocn_,:digest,:tmp
+    def initialize
+      @of=:block
+      @is=@obj=@lngsyn=@idx=@ocn=@odv=@osp=@parent=@note_=@number_=@ocn_=@digest=@tmp=nil
+      @tags=[]
+    end
+    def code(h,o=nil)
+      of       = @of                                                                #Symbol, classification - group #alt 'code'
+      is       = :code                                                              #Symbol, classification - specific type
+      tags     = h[:tags]       || ((defined? o.tags)      ? o.tags        : [])    #Array, associated object tags, names if any
+      obj      = h[:obj]        || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      lngsyn   = h[:lngsyn]     || ((defined? o.lngsyn)    ? o.lngsyn      : :txt)  #symbol, code lngsyn
+      idx      = h[:idx]        || ((defined? o.idx)       ? o.idx         : nil)   #String, book index provided?
+      ocn      = h[:ocn]        || ((defined? o.ocn)       ? o.ocn         : nil)   #Integer, sequential on substantive-content objects
+      odv      = h[:odv]        || ((defined? o.odv)       ? o.odv         : nil)
+      osp      = h[:osp]        || ((defined? o.osp)       ? o.osp         : nil)
+      parent   = h[:parent]     || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      number_  = h[:number_]    || ((defined? o.number_)   ? o.number_     : false) #Bool, numbered or not?
+      note_    = h[:note_]      || ((defined? o.note_)     ? o.note_       : false) #Bool, endnotes/footnotes? (processing optimization)
+      ocn_     = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else                         h[:ocn_]
+      end
+      num      = h[:num]        || ((defined? o.num)       ? o.num         : nil)
+      digest   = h[:digest]     || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp      = h[:tmp]        || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@tags,@obj,@lngsyn,@idx,@ocn,@odv,@osp,@parent,@number_,@note_,@ocn_,@num,@digest,@tmp=
+      of, is, tags, obj, lngsyn, idx, ocn, odv, osp, parent, number_, note_, ocn_, num, digest, tmp
+      self
+    end
+    def box(h,o=nil)
+      of       = @of                                                                #Symbol, classification - group
+      is       = :box                                                               #Symbol, classification - specific type
+      tags     = h[:tags]       || ((defined? o.tags)      ? o.tags        : [])    #Array, associated object tags, names if any
+      obj      = h[:obj]        || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      idx      = h[:idx]        || ((defined? o.idx)       ? o.idx         : nil)   #String, book index provided?
+      ocn      = h[:ocn]        || ((defined? o.ocn)       ? o.ocn         : nil)   #Integer, sequential on substantive-content objects
+      odv      = h[:odv]        || ((defined? o.odv)       ? o.odv         : nil)
+      osp      = h[:osp]        || ((defined? o.osp)       ? o.osp         : nil)
+      parent   = h[:parent]     || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      note_    = h[:note_]      || ((defined? o.note_)     ? o.note_       : false) #Bool, endnotes/footnotes? (processing optimization)
+      ocn_     = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else                         h[:ocn_]
+      end
+      num      = h[:num]        || ((defined? o.num)       ? o.num         : nil)
+      digest   = h[:digest]     || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp      = h[:tmp]        || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@tags,@obj,@idx,@ocn,@odv,@osp,@parent,@note_,@ocn_,@num,@digest,@tmp=
+      of, is, tags, obj, idx, ocn, odv, osp, parent, note_, ocn_, num, digest, tmp
+      self
+    end
+    def block(h,o=nil)
+      of       = @of                                                                #Symbol, classification - group
+      is       = :block                                                             #Symbol, classification - specific type
+      tags     = h[:tags]       || ((defined? o.tags)      ? o.tags        : [])    #Array, associated object tags, names if any
+      obj      = h[:obj]        || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      idx      = h[:idx]        || ((defined? o.idx)       ? o.idx         : nil)   #String, book index provided?
+      ocn      = h[:ocn]        || ((defined? o.ocn)       ? o.ocn         : nil)   #Integer, sequential on substantive-content objects
+      odv      = h[:odv]        || ((defined? o.odv)       ? o.odv         : nil)
+      osp      = h[:osp]        || ((defined? o.osp)       ? o.osp         : nil)
+      parent   = h[:parent]     || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      note_    = h[:note_]      || ((defined? o.note_)     ? o.note_       : false) #Bool, endnotes/footnotes? (processing optimization)
+      ocn_     = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else                         h[:ocn_]
+      end
+      num      = h[:num]        || ((defined? o.num)       ? o.num         : nil)
+      digest   = h[:digest]     || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp      = h[:tmp]        || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@tags,@obj,@idx,@ocn,@odv,@osp,@parent,@note_,@ocn_,@num,@digest,@tmp=
+      of, is, tags, obj, idx, ocn, odv, osp, parent, note_, ocn_, num, digest, tmp
+      self
+    end
+    def group(h,o=nil)
+      of       = @of                                                                #Symbol, classification - group
+      is       = :group                                                             #Symbol, classification - specific type
+      tags     = h[:tags]       || ((defined? o.tags)      ? o.tags        : [])    #Array, associated object tags, names if any
+      obj      = h[:obj]        || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      idx      = h[:idx]        || ((defined? o.idx)       ? o.idx         : nil)   #String, book index provided?
+      ocn      = h[:ocn]        || ((defined? o.ocn)       ? o.ocn         : nil)   #Integer, sequential on substantive-content objects
+      odv      = h[:odv]        || ((defined? o.odv)       ? o.odv         : nil)
+      osp      = h[:osp]        || ((defined? o.osp)       ? o.osp         : nil)
+      parent   = h[:parent]     || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      note_    = h[:note_]      || ((defined? o.note_)     ? o.note_       : false) #Bool, endnotes/footnotes? (processing optimization)
+      ocn_     = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else          h[:ocn_]
+      end
+      num      = h[:num]        || ((defined? o.num)       ? o.num         : nil)
+      digest   = h[:digest]     || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp      = h[:tmp]        || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@tags,@obj,@idx,@ocn,@odv,@osp,@parent,@note_,@ocn_,@num,@digest,@tmp=
+      of, is, tags, obj, idx, ocn, odv, osp, parent, note_, ocn_, num, digest, tmp
+      self
+    end
+    def alt(h,o=nil)                                                                #see block
+      of       = @of                                                                #Symbol, classification - group
+      is       = :alt                                                               #Symbol, classification - specific type
+      tags     = h[:tags]       || ((defined? o.tags)      ? o.tags        : [])    #Array, associated object tags, names if any
+      obj      = h[:obj]        || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      idx      = h[:idx]        || ((defined? o.idx)       ? o.idx         : nil)   #String, book index provided?
+      ocn      = h[:ocn]        || ((defined? o.ocn)       ? o.ocn         : nil)   #Integer, sequential on substantive-content objects
+      odv      = h[:odv]        || ((defined? o.odv)       ? o.odv         : nil)
+      osp      = h[:osp]        || ((defined? o.osp)       ? o.osp         : nil)
+      parent   = h[:parent]     || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      note_    = h[:note_]      || ((defined? o.note_)     ? o.note_       : false) #Bool, endnotes/footnotes? (processing optimization)
+      ocn_     = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else                         h[:ocn_]
+      end
+      num      = h[:num]        || ((defined? o.num)       ? o.num         : nil)
+      digest   = h[:digest]     || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp      = h[:tmp]        || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@tags,@obj,@idx,@ocn,@odv,@osp,@parent,@note_,@ocn_,@num,@digest,@tmp=
+      of, is, tags, obj, idx, ocn, odv, osp, parent, note_, ocn_, num, digest, tmp
+      self
+    end
+    def verse(h,o=nil)                                                              #part of poem decide how you deal with this
+      of       = @of                                                                #Symbol, classification - group
+      is       = :verse                                                             #Symbol, classification - specific type
+      tags     = h[:tags]       || ((defined? o.tags)      ? o.tags        : [])    #Array, associated object tags, names if any
+      obj      = h[:obj]        || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      idx      = h[:idx]        || ((defined? o.idx)       ? o.idx         : nil)   #String, book index provided?
+      ocn      = h[:ocn]        || ((defined? o.ocn)       ? o.ocn         : nil)   #Integer, sequential on substantive-content objects
+      odv      = h[:odv]        || ((defined? o.odv)       ? o.odv         : nil)
+      osp      = h[:osp]        || ((defined? o.osp)       ? o.osp         : nil)
+      parent   = h[:parent]     || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      ocn_     = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else                         h[:ocn_]
+      end
+      num      = h[:num]        || ((defined? o.num)       ? o.num         : nil)
+      digest   = h[:digest]     || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp      = h[:tmp]        || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@tags,@obj,@idx,@ocn,@odv,@osp,@parent,@note_,@ocn_,@num,@digest,@tmp=
+      of, is, tags, obj, idx, ocn, odv, osp, parent, note_, ocn_, num, digest, tmp
+      @h=nil
+      self
+    end
+  end
+  class ObjectTable
+    attr_accessor :obj,:is,:of,:lv,:tags,:name,:idx,:indent,:hang,:size,:ocn,:num,:head_,:cols,:widths,:odv,:osp,:parent,:note_,:ocn_,:digest,:tmp
+    def initialize
+      @of=:block
+      @is=@obj=@lv=@name=@idx=@indent=@hang=@size=@ocn,@num,@head_,@cols,@widths=@odv=@osp=@parent=@note_=@ocn_=@num=@digest=@tmp=nil
+      @tags=[]
+    end
+    def table(h,o=nil)
+      of      = @of                                                                 #Symbol, classification - group
+      is      = :table                                                              #Symbol, classification - specific type
+      tags    = h[:tags]        || ((defined? o.tags)      ? o.tags        : [])    #Array, associated object tags, names if any
+      cols    = h[:cols]        || ((defined? o.cols)      ? o.cols        : nil)
+      widths  = h[:widths]      || ((defined? o.widths)    ? o.widths      : nil)
+      obj     = h[:obj]         || ((defined? o.obj)       ? o.obj         : nil)   #String, text content
+      idx     = h[:idx]         || ((defined? o.idx)       ? o.idx         : nil)   #String, book index provided?
+      ocn     = h[:ocn]         || ((defined? o.ocn)       ? o.ocn         : nil)   #Integer, sequential on substantive-content objects
+      odv     = h[:odv]         || ((defined? o.odv)       ? o.odv         : nil)
+      osp     = h[:osp]         || ((defined? o.osp)       ? o.osp         : nil)
+      parent  = h[:parent]      || ((defined? o.parent)    ? o.parent      : nil)   #[Node parent]
+      head_   = h[:head_]       || ((defined? o.head_)     ? o.head_       : false)
+      note_   = h[:note_]       || ((defined? o.note_)     ? o.note_       : false) #Bool, endnotes/footnotes? (processing optimization)
+      ocn_    = if h[:ocn_].nil?
+                                   ((defined? o.ocn_)      ? o.ocn_        : true)  #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else                         h[:ocn_]
+      end
+      num     = h[:num]         || ((defined? o.num)       ? o.num         : nil)
+      digest  = h[:digest]      || ((defined? o.digest)    ? o.digest      : nil)   #hash digests, sha512, sha256 or md5
+      tmp     = h[:tmp]         || ((defined? o.tmp)       ? o.tmp         : nil)   #available for processing, empty after use
+      @of,@is,@tags,@cols,@widths,@obj,@idx,@ocn,@odv,@osp,@parent,@head_,@note_,@ocn_,@num,@digest,@tmp=
+      of, is, tags, cols, widths, obj, idx, ocn, odv, osp, parent, head_, note_, ocn_, num, digest, tmp
+      self
+    end
+  end
+  class ObjectImage
+    attr_accessor :obj,:is,:of,:lv,:idx,:size,:ocn,:parent,:note_,:ocn_,:digest,:tmp
+    def initialize
+      @of=:image
+      @is=@obj=@lv=@idx=@size=@ocn=@parent=@note_=@ocn_=@tmp=@digest=nil
+      @tags=[]
+    end
+    def image(h,o=nil)                                                         #not yet used, and what of a paragraph containing several images, consider
+      of=     @of                                                              #Symbol, classification - group
+      is=     :image                                                           #Symbol, classification - specific type
+      tags=   h[:tags]    || ((defined? o.tags)      ? o.tags    : [])         #Array, associated object tags, names if any
+      obj=    h[:obj]     || ((defined? o.obj)       ? o.obj     : nil)        #String, text content
+      size=   h[:size]    || ((defined? o.size)      ? o.size    : nil)
+      idx=    h[:idx]     || ((defined? o.idx)       ? o.idx     : nil)        #String, book index provided?
+      ocn=    h[:ocn]     || ((defined? o.ocn)       ? o.ocn     : nil)        #Integer, sequential on substantive-content objects
+      odv=    h[:odv]     || ((defined? o.odv)       ? o.odv     : nil)
+      osp=    h[:osp]     || ((defined? o.osp)       ? o.osp     : nil)
+      parent= h[:parent]  || ((defined? o.parent)    ? o.parent  : nil)        #[Node parent]
+      note_=  h[:note_]   || ((defined? o.note_)     ? o.note_   : false)      #Bool, endnotes/footnotes? (processing optimization)
+      ocn_=if h[:ocn_].nil?
+                             ((defined? o.ocn_)  ? o.ocn_    : true)           #Bool? no ocn, non-substantive content, do not include in toc #consider
+      else                   h[:ocn_]
+      end
+      digest= h[:digest]  || ((defined? o.digest)    ? o.digest  : nil)        #hash digests, sha512, sha256 or md5
+      tmp=    h[:tmp]     || ((defined? o.tmp)       ? o.tmp     : nil)        #available for processing, empty after use
+      @of,@is,@tags,@obj,@size,@idx,@ocn,@odv,@osp,@parent,@note_,@ocn_,@digest,@tmp=of,is,tags,obj,size,idx,ocn,odv,osp,parent,note_,ocn_,digest,tmp
+      self
+    end
+  end
+  class ObjectStructure
+    attr_accessor :obj,:tag,:node,:lv,:ln,:lc,:status,:is,:of,:tmp
+    def initialize
+      @of=:structure
+      @is=@obj=@node=@lv=@ln=@lc=@status=@tmp=nil
+    end
+    def xml_dom(h,o=nil)
+      of=     @of                                                              #Symbol, classification - group
+      is=     :xml_dom                                                         #Symbol, classification - specific type
+      obj=    h[:obj]     || ((defined? o.obj)       ? o.obj     : '')         #String, text content
+      lv=     h[:lv]      || ((defined? o.lv)        ? o.lv      : nil)        #Alpha-numeric, document structure as used in markup, A-D then 1-6
+      ln=     h[:ln]      || ((defined? o.ln)        ? o.ln      : nil)        #Integer, document structure level, for convenience in processing 1-9
+      lc=     h[:lc]      || ((defined? o.lc)        ? o.lc      : nil)        #Integer, document structure collapsed level, convenience (collapse sisu's dual level document structure for markup with simple linear structure)
+      node=   h[:node]    || ((defined? o.node)      ? o.node    : nil)        #[Node relationship doc structure info]
+      status= h[:status]  || ((defined? o.status)    ? o.status  : nil)        #tag status Symbol :open or :close
+      tmp=    h[:tmp]     || ((defined? o.tmp)       ? o.tmp     : nil)        #available for processing, empty after use
+      @of,@is,@obj,@status,@node,@lv,@ln,@lc,@tmp=of,is,obj,status,node,lv,ln,lc,tmp
+      self
+    end
+  end
+  class ObjectFlag
+    attr_accessor :obj,:is,:of,:flag,:act,:selections,:tmp
+    def initialize
+      @of=:flag
+      @is=@obj=@flag=@act=@selections=@tmp=nil
+    end
+    def flag(h,o=nil)
+      of=     @of                                                              #Symbol, classification - group
+      is=     :flag                                                            #Symbol, classification - specific type
+      obj=    nil                                                              #String, text content
+      flag=   h[:flag]     || ((defined? o.flag)      ? o.flag    : nil)       #String, text content
+      act=    h[:act]      || ((defined? o.act)       ? o.act     : nil)       #String, text content
+      selections=    h[:selections]      || ((defined? o.selections) ? o.selections : nil)   #String, text content
+      tmp=    h[:flag]     || ((defined? o.tmp)       ? o.tmp     : nil)       #available for processing, empty after use
+      @of, @is,@obj,@flag,@act,@selections,@tmp=
+        of,is, obj, flag, act, selections, tmp
+      self
+    end
+    def flag_ocn(h,o=nil)
+      of=     @of                                                              #Symbol, classification - group
+      is=     :flag_ocn                                                        #Symbol, classification - specific type
+      obj=    nil                                                              #String, text content
+      flag=   h[:flag]     || ((defined? o.flag)      ? o.flag    : nil)       #String, text content
+      act=    h[:act]      || ((defined? o.act)       ? o.act     : nil)       #String, text content
+      selections= h[:selections] || ((defined? o.selections) ? o.selections : nil)   #String, text content
+      tmp=    h[:flag]     || ((defined? o.tmp)       ? o.tmp     : nil)       #available for processing, empty after use
+      @of, @is,@obj,@flag,@act,@selections,@tmp=
+        of,is, obj, flag, act, selections,tmp
+      self
+    end
+    def flag_lng(h,o=nil)
+      of=     @of                                                              #Symbol, classification - group
+      is=     :flag_lng
+      obj=    nil                                                              #String, text content
+      flag=   h[:flag]     || ((defined? o.flag)      ? o.flag    : nil)       #Symbol, :lng_on or :lng_off
+      act=    h[:act]      || ((defined? o.act)       ? o.act     : nil)       #Symbol, language set to :en etc.
+      selections= h[:selections] || ((defined? o.selections) ? o.selections : nil)   #String, text content
+      tmp=    h[:act]     || ((defined? o.tmp)       ? o.tmp     : nil)       #available for processing, empty after use
+      @of, @is,@obj,@flag,@act,@selections,@tmp=
+        of,is, obj, flag, act, selections,tmp
+      self
+    end
+  end
+  class ObjectLayout
+    attr_accessor :obj,:sym,:attr,:is,:is_for,:of,:from,:tmp,:num
+    def initialize
+      @of=:layout
+      @is=@is_for=@obj=@from=@tmp=@num=nil
+    end
+    def break(h,f=nil)                                                         #decide how to deal with
+      of=     @of                                                              #Symbol, classification - group
+      is=     :break                                                           #Symbol, classification - specific type
+      obj=    h[:obj]                                                          #String, text content
+      from=   f
+      tmp=    h[:tmp]                                                          #available for processing, empty after use
+      @of,@is,@obj,@from,@tmp=of,is,obj,from,tmp
+      self
+    end
+    def insert(h,o=nil)                                                        #decide how to deal with, could mimic paragraph?
+      of=     @of                                                              #Symbol, classification - group
+      is=     :insert                                                          #Symbol, classification - specific type
+      obj=    h[:obj]     || ((defined? o.obj)       ? o.obj     : nil)        #String, text content
+      tmp=    h[:tmp]     || ((defined? o.tmp)       ? o.tmp     : nil)        #available for processing, empty after use
+      @of,@is,@obj,@tmp=of,is,obj,tmp
+      self
+    end
+    def open_close(h,o=nil)                                                    #useful for poem & quote
+      of=     @of                                                              #Symbol, classification - group
+      is=     :open_close_tags                                                 #Symbol, classification - specific type
+      is_for= h[:is_for]  || ((defined? o.is_for)    ? o.is_for  : nil)        #String, text content
+      obj=    h[:obj]     || ((defined? o.obj)       ? o.obj     : nil)        #String, text content
+      sym=    h[:sym]     || ((defined? o.sym)       ? o.sym     : nil)        #Symbol tag_open, tag_close
+      attr=   h[:attr]    || ((defined? o.attr)      ? o.attr    : nil)        #String, text content
+      tmp=    h[:tmp]     || ((defined? o.tmp)       ? o.tmp     : nil)        #available for processing, empty after use
+      num=    h[:num]     || ((defined? o.num)       ? o.num     : nil)
+      @of,@is,@is_for,@obj,@sym,@attr,@tmp,@num=
+      of, is, is_for, obj, sym, attr, tmp, num
+      self
+    end
+  end
+  class ObjectComment
+    attr_accessor :obj,:is,:of,:tmp
+    def initialize
+      @of=:comment
+      @is=@obj=@tmp=nil
+    end
+    def comment(h,o=nil)
+      of=     @of                                                              #Symbol, classification - group
+      is=     :comment                                                         #Symbol, classification - specific type
+      obj=    h[:obj]     || ((defined? o.obj)       ? o.obj     : nil)        #String, text content
+      tmp=    h[:tmp]     || ((defined? o.tmp)       ? o.tmp     : nil)        #available for processing, empty after use
+      @of,@is,@obj,@tmp=of,is,obj,tmp
+      self
+    end
+  end
+end
+__END__
+# ~# |-# no paragraph number # -# not included in toc