dyndoc-ruby-core 1.0.0

data/lib/dyndoc/common/file.rb

@@ -0,0 +1,52 @@
+module Dyndoc
+
+	# allows to expand subpath of the form 'lib/<dyndoc/tutu/toto' 
+	def Dyndoc.expand_path(filename)
+		filename=File.expand_path(filename).split(File::Separator)
+		to_find=filename.each_with_index.map{|pa,i| i if pa =~ /^\<[^\<\>]*/}.compact
+		return File.join(filename) if to_find.empty?
+		to_find=to_find[0]
+		path=Dyndoc.find_subpath_before(File.join(filename[to_find][1..-1],filename[(to_find+1)...-1]),filename[0...to_find])
+		return path ? Dyndoc.expand_path(File.join(path+filename[-1,1])) : nil
+	end
+
+	def Dyndoc.find_subpath_before(subpath,before)
+		l=before.length+1
+		return [before[0..l],subpath] if File.exists? File.join(before[0..l],subpath) while (l-=1)>=0
+		return nil
+	end
+
+end
+
+## inspired from http://stackoverflow.com/questions/21511347/how-to-create-a-symlink-on-windows-via-ruby
+require 'open3'
+
+class << File
+  alias_method :old_symlink, :symlink
+  alias_method :old_symlink?, :symlink?
+
+  def symlink(target_name, link_name)
+    #if on windows, call mklink, else self.symlink
+    if RUBY_PLATFORM =~ /mswin32|cygwin|mingw|bccwin/
+      #windows mklink syntax is reverse of unix ln -s
+      #windows mklink is built into cmd.exe
+      #vulnerable to command injection, but okay because this is a hack to make a cli tool work.
+      opt = (File.directory? target_name) ? "/D" : ""
+      stdin, stdout, stderr, wait_thr = Open3.popen3('cmd.exe', "/c mklink " + opt + "#{link_name} #{target_name}")
+      wait_thr.value.exitstatus
+    else
+      self.old_symlink(target_name, link_name)
+    end
+  end
+
+  def symlink?(file_name)
+    #if on windows, call mklink, else self.symlink
+    if RUBY_PLATFORM =~ /mswin32|cygwin|mingw|bccwin/
+      #vulnerable to command injection because calling with cmd.exe with /c?
+      stdin, stdout, stderr, wait_thr = Open3.popen3("cmd.exe /c dir #{file_name} | find \"SYMLINK\"")
+      wait_thr.value.exitstatus
+    else
+      self.old_symlink?(file_name)
+    end
+  end
+end

data/lib/dyndoc/common/init.rb

@@ -0,0 +1,2 @@
+## CONSTANT to be defined first
+PANDOC_CMDS=["--md2odt","--md2docx","--md2beamer","--md2dzslides","--md2slideous","--md2slidy","--md2s5","--md2slidy","--md2revealjs","--tex2odt","--tex2docx"]

data/lib/dyndoc/common/tilt.rb

@@ -0,0 +1,149 @@
+require 'tilt' #this allows the use of any other template 
+require 'tilt/template' #for creating the dyndoc one
+require 'redcloth'
+
+
+module Tilt
+  
+  class DynDocTemplate < Template
+
+    def DynDocTemplate.init(libs=nil)
+      unless $curDyn
+        require 'dyndoc/V3/init/dyn'
+        CqlsDoc.init_dyn
+        CqlsDoc.set_curDyn(:V3)
+        $curDyn.init(false)
+        $curDyn.tmpl_doc.init_doc
+        if libs
+          @@libs=libs
+          $curDyn.tmpl_doc.require_dyndoc_libs(libs)
+        end 
+        "options(bitmapType='cairo')".to_R
+        $curDyn.tmpl.format_output="html"
+        $curDyn.tmpl.dyndoc_mode=:web # No command line
+        #p [$curDyn.tmpl.dyndocMode,$curDyn.tmpl.fmtOutput]
+      end
+    end
+
+    # def init_dyndoc
+    #   unless @tmpl_mngr
+    #     Dyndoc.cfg_dyn['dyndoc_session']=:interactive
+    #     @tmpl_mngr = Dyndoc::Ruby::TemplateManager.new({})
+    #     ##is it really well-suited for interactive mode???
+    #     @tmpl_mngr.init_doc({:format_output=> "html"})
+    #     puts "InteractiveServer initialized!\n"
+    #   end
+    # end
+    
+    def self.engine_initialized?
+      defined? ::DynDoc
+    end
+
+    def initialize_engine
+    	DynDocTemplate.init
+    end
+
+    def prepare; end
+
+
+    def prepare_output
+		  return $curDyn.tmpl_doc.make_content(data)
+    end
+ 
+    def evaluate(scope, locals, &block)
+ 
+#=begin
+      #puts "locals";p locals
+      ## first!!!!
+      if locals.keys.include? :init_doc and locals[:init_doc]
+          $curDyn.tmpl_doc.init_doc
+          $curDyn.tmpl_doc.require_dyndoc_libs(@@libs) if @@libs
+          "options(bitmapType='cairo')".to_R
+          $curDyn.tmpl.format_output="html"
+          $curDyn.tmpl.dyndoc_mode=:web # No command line
+        #p [$curDyn.tmpl.dyndocMode,$curDyn.tmpl.fmtOutput]
+          locals.delete :init_doc
+      end
+    	locals.each do |tag, value|
+          if tag==:path
+            CqlsDoc.setRootDoc($curDyn[:rootDoc],value)
+          elsif tag==:libs
+            @@libs=libs
+          else
+        	 $curDyn.tmpl.filterGlobal.envir[tag]=value
+          end
+      end
+#=end
+      $curDyn.tmpl.filterGlobal.envir["yield"]=block.call if block
+    	@output=prepare_output
+    	#puts @output
+    	#@output
+    end
+
+  end
+
+  class DynTtmTemplate < DynDocTemplate
+
+    def self.engine_initialized?
+      defined? ::DynTtm
+    end
+
+    def prepare_output
+=begin
+      ttm_preamble = <<-PREAMBLE
+          \def\hyperlink#1#2{\special{html:<a href="\##1">}#2\special{html:</a>}}
+            % Incorrect link name in \TeX\ because # can't be passed properly to a special.
+          \def\hypertarget#1#2{\special{html:<a name="#1">}#2\special{html:</a>}}
+          \long\def\ttmdump#1{#1} % Do nothing. The following are not done for TtM.
+          \ttmdump{%
+          \def\title#1{\bgroup\leftskip 0 pt plus1fill \rightskip 0 pt plus1fill
+          \pretolerance=100000 \lefthyphenmin=20 \righthyphenmin=20
+          \noindent #1 \par\egroup}% Centers a possibly multi-line title.
+           \let\author=\title % Actually smaller font than title in \LaTeX.
+           \input epsf     % PD package defines \epsfbox for figure inclusion
+            % Macro for http reference inclusion, per hypertex.
+           \def\href#1#2{\special{html:<a href="#1">}#2\special{html:</a>}}
+           \def\urlend#1{#1\endgroup}
+           \def\url{\begingroup \tt 
+            \catcode`\_=13 % Don't know why this works.
+            \catcode`\~=11 \catcode`\#=11 \catcode`\^=11 
+            \catcode`\$=11 \catcode`\&=11 \catcode`\%=11
+          \urlend}% \url for plain \TeX.
+          PREAMBLE
+=end
+	    CqlsDoc::Converter.ttm($curDyn.tmpl_doc.make_content(data),"-e2 -r -y1 -L").gsub(/<mtable[^>]*>/,"<mtable>").gsub("\\ngtr","<mtext>&ngtr;</mtext>").gsub("\\nless","<mtext>&nless;</mtext>").gsub("&#232;","<mtext>&egrave;</mtext>")
+    end
+
+  end
+
+
+  class DynTxtlTemplate < DynDocTemplate
+
+    def self.engine_initialized?
+      defined? ::DynTxtl
+    end
+
+    def prepare_output
+       RedCloth.new($curDyn.tmpl_doc.make_content(data)).to_html
+    end
+
+  end
+
+  class DynHtmlTemplate < DynDocTemplate
+
+    def self.engine_initialized?
+      defined? ::DynHtml
+    end
+
+  end
+
+
+
+end
+
+## register them!
+Tilt.register Tilt::DynTxtlTemplate,  '_txtl.dyn'
+Tilt.register Tilt::DynTtmTemplate,   '_ttm.dyn'
+Tilt.register Tilt::DynHtmlTemplate,  '_html.dyn'
+Tilt.register Tilt::DynDocTemplate,   '.dyn'
+#puts "dyn registered in tilt!"

data/lib/dyndoc/common/utils.rb

@@ -0,0 +1,61 @@
+module Dyndoc
+
+	def Dyndoc.stdout
+		old_stdout,$stdout=$stdout,STDOUT
+		yield
+		$stdout=old_stdout
+	end
+
+	def Dyndoc.warn(*txt) # 1 component => puts, more components => puts + p + p + ....
+		Dyndoc.stdout  do
+			if txt.length==1
+				puts txt[0]
+			else
+				puts txt[0]
+				txt[1..-1].each do |e| p e end
+			end
+		end
+	end
+
+	module Utils
+		def Utils.cfg_file_exists?(tmpl)
+	      name=File.join(File.dirname(tmpl),File.basename(tmpl,".*"))
+	      ([".cfg_dyn",".dyn_cfg"].map{|ext| name+ext}.select{|f| File.exists? f})[0]
+	    end
+
+	    def Utils.lib_file_exists?(tmpl)
+	      name=File.join(File.dirname(tmpl),File.basename(tmpl,".*"))
+	      (["_lib.dyn",".dyn_lib"].map{|ext| name+ext}.select{|f| File.exists? f})[0]
+	    end
+
+	    def Utils.out_rsrc_exists?(tmpl)
+	      name=File.join(File.dirname(tmpl),File.basename(tmpl,".*"))
+	      ## if not a directory it is the zipped version! TODO! 
+	      ([".dyn_out",".dyn_rsrc"].map{|ext| name+ext}.select{|f| File.exists? f})[0]
+	    end
+
+	    def Utils.mkdir_out_rsrc(tmpl)
+	    	require 'fileutils'
+	    	#p File.join(File.dirname(tmpl),File.basename(tmpl,".*")+".dyn_out")
+	    	FileUtils.mkdir_p File.join(File.dirname(tmpl),File.basename(tmpl,".*")+".dyn_out")
+	    end
+
+    end
+
+    def Utils.dyndoc_globvar(key,value=nil)
+		if value
+            if [:remove,:rm,:del,:delete].include?  value
+                Dyndoc.tmpl_mngr.filterGlobal.envir.remove(key)
+            else
+			     Dyndoc.tmpl_mngr.filterGlobal.envir[key]= value
+            end
+		else
+			Dyndoc.tmpl_mngr.filterGlobal.envir[key]
+		end
+	end
+
+	def Utils.is_windows?
+		RUBY_PLATFORM =~ /(win|msys|mingw)/
+	end
+
+end

data/lib/dyndoc/common/uv.rb

@@ -0,0 +1,163 @@
+require 'uv'
+require 'textpow'
+
+## fix Textpow::ScoreManager::START_VALUE class supposed to be a Bignum
+unless Textpow::ScoreManager::START_VALUE.is_a? Bignum
+  require 'bigdecimal'
+  Textpow::ScoreManager.send(:remove_const,:START_VALUE)
+  Textpow::ScoreManager.const_set(:START_VALUE,(BigDecimal("2") ** ( Textpow::ScoreManager::POINT_DEPTH * Textpow::ScoreManager::NESTING_DEPTH )).to_i)
+end
+
+module Uv
+
+  self.syntax_path=File.join(Dyndoc.cfg_dir[:etc],"uv","syntax")
+  self.render_path=File.join(Dyndoc.cfg_dir[:etc],"uv","render")
+
+  def self.parse(text, output = "xhtml", syntax_name = nil, line_numbers = false, render_style = nil, headers = false)
+    Dyndoc::RenderProcessor.load(output, render_style, line_numbers, headers) do |processor|
+      syntax_node_for(syntax_name).parse(text, processor)
+    end.string
+  end
+
+end
+
+module Dyndoc
+
+  class RenderProcessor
+    @@score_manager = Textpow::ScoreManager.new
+
+    attr_reader :string
+    attr_accessor :escapeHTML
+
+    def self.load(output, style = nil, line_numbers = false, headers = false)
+      style  ||= Uv.default_style
+      renderer = File.join( Uv.render_path, output,"#{style}.render")
+      raise( ArgumentError, "Output for #{output} in #{style} style is not yet implemented" ) unless File.exists?(renderer)
+      options   = YAML.load_file(renderer)
+      processor = RenderProcessor.new(options, line_numbers, headers)
+      yield processor if block_given?
+      processor
+    end
+
+    def initialize render_options, line_numbers = false, headers = true, score_manager = nil
+      @score_manager  = score_manager || @@score_manager
+      @render_options = render_options
+      @options        = {}
+      @headers        = headers
+      @line_numbers   = line_numbers
+      @escapeHTML     = true
+    end
+    
+    def start_parsing name
+      @stack       = [name]
+      @string      = ""
+      @line        = nil
+      @line_number = 0
+      ## Dyndoc.warn "render_options",@render_options["listing"]
+      print @render_options["document"]["begin"] if @headers
+      ## FIX (01/09/2014): "begin-line-numbers" undefined for xhtml and has to replaced by "begin" 
+      print (@line_numbers ? @render_options["listing"]["begin"] : @render_options["listing"]["begin-line-numbers"] || @render_options["listing"]["begin"])
+      #         opt = options @stack
+      #         print opt["begin"] if opt
+    end
+    
+    def print string
+      @string << string
+    end
+    
+    def escape string
+      if @render_options["filter"]
+        @escaped = string
+        @escaped = self.instance_eval( @render_options["filter"] )
+        @escaped
+      else
+        string
+      end
+    end
+    
+    def open_tag name, position
+      @stack << name
+      print escape(@line[@position...position].gsub(/\n|\r/, '')) if position > @position
+      @position = position
+      opt = options @stack
+      print opt["begin"] if opt
+    end
+    
+    def close_tag name, position
+      print escape(@line[@position...position].gsub(/\n|\r/, '')) if position > @position
+      @position = position
+      opt = options @stack
+      print opt["end"] if opt
+      @stack.pop
+    end
+    
+    def close_line
+      stack = @stack[0..-1]
+      while stack.size > 1
+        opt = options stack
+        print opt["end"] if opt
+        stack.pop
+      end
+    end
+    
+    def open_line
+      stack = [@stack.first]
+      clone = @stack[1..-1]
+      while stack.size < @stack.size
+        stack << clone.shift
+        opt = options stack
+        print opt["begin"] if opt
+      end
+    end
+    
+    def new_line line
+      if @line
+        print escape(@line[@position..-1].gsub(/\n|\r/, ''))
+        close_line
+        print @render_options["line"]["end"]
+        print "\n" 
+      end
+      @position = 0
+      @line_number += 1
+      @line = line
+      print @render_options["line"]["begin"]
+      if @line_numbers
+        print @render_options["line-numbers"]["begin"] 
+        print @line_number.to_s.rjust(4).ljust(5)
+        print @render_options["line-numbers"]["end"] 
+        print " "
+      end
+      open_line
+    end
+    
+    def end_parsing name
+      if @line
+        print escape(@line[@position..-1].gsub(/\n|\r/, '')) 
+        while @stack.size > 1
+          opt = options @stack
+          print opt["end"] if opt
+          @stack.pop
+        end
+        print @render_options["line"]["end"]
+        print "\n"
+      end
+      #         opt = options @stack
+      #         print opt["end"] if opt
+      @stack.pop
+      print @render_options["listing"]["end"]
+      print @render_options["document"]["end"] if @headers
+    end
+    
+    def options stack
+      ref = stack.join ' '
+      return @options[ref] if @options.has_key? ref
+    
+      result = @render_options['tags'].max do |a, b| 
+        @score_manager.score( a['selector'], ref ) <=> @score_manager.score( b['selector'], ref )
+      end
+      result = nil if @score_manager.score( result['selector'], ref ) == 0
+      @options[ref] = result
+    end
+  end
+end
+

data/lib/dyndoc/init/config.rb

@@ -0,0 +1,296 @@
+require 'fileutils'
+
+module Dyndoc
+
+  FORMATS=["Tex","Txtl","Txt","Tm","Ttm","Html"]
+
+# first declaration of the config directory
+  @@dyn_root_path=Settings['path.dyn_home']
+  @@dyn_gem_path=File.expand_path(File.join(__FILE__,[".."]*4))
+  @@cfg_dir={
+    :root_path=> @@dyn_root_path,
+    :gem_path=> @@dyn_gem_path,
+    :log_file => File.join(@@dyn_root_path,".dyn_log"),
+    :etc => File.join(@@dyn_root_path,"etc"),
+    :tmpl_path=>{:tex=>"Tex",:odt=>"Odt",:ttm=>"Ttm",:html => "Html"},
+    :model_default=>"Model",
+    :file => "", #to complete when dyndoc applied to a file
+    :current_doc_path => "" #completed each time a file is parsed in parse_do 
+  }
+
+  require 'logger'
+  @@dyn_logger = Logger.new @@cfg_dir[:log_file], 7, 1048576
+
+  def Dyndoc.cfg_dir
+    @@cfg_dir
+  end
+
+  def Dyndoc.cfg_dyn
+    Settings[:cfg_dyn]
+  end
+
+  def Dyndoc.logger
+    @@dyn_logger
+  end
+
+  @@dyn_block={}
+
+  def Dyndoc.dyn_block
+    @@dyn_block
+  end
+
+  ## default mode and extension
+  @@mode=:txt
+  @@tmplExt={:txt => ["_txt.dyn","_raw.dyn",".dyn_txt","_tmpl.txt",".dyn"], :rb =>["_rb.dyn",".dyn_rb","_tmpl.rb",".dyn"], :c=>["_c.dyn",".dyn_c","_tmpl.c",".dyn"], :html => ["_html.dyn",".dyn_html","_tmpl.html","_tmpl.rhtml",".dyn"],:txtl=>["_txtl.dyn",".dyn_txtl","_tmpl.txtl","_tmpl.rhtml",".dyn"],
+  :tm=>["_tm.dyn",".dyn_tm","_tmpl.tm",".dyn"],
+  :tex=>["_tex.dyn",".dyn_tex","_tmpl.tex",".dyn",".rtex"],
+  :odt=>[".dyn_odt_content","_tmpl_content.xml",".dyn_odt_styles","_tmpl_styles.xml",".dyn_odt","_tmpl.odt",".dyn"], #_tmpl.odt is an odt file with content body to extract!
+  :ttm=>["_ttm.dyn",".dyn_ttm","_tmpl.ttm",".dyn"],
+  :all=>[".dyn"]
+  }
+
+  @@docExt={:raw => "",:txt => ".txt",:rb => ".rb",:c=>".c",:html=>".html",:txtl=>".rhtml",:tm=>".tm",:tex=>".tex",:odt=>".odt",:ttm=>"_ttm.xml"}
+
+  @@dynExt=[".dyn"]
+
+  EXTS={:txt => ".txt",:rb => ".rb",:c=>".c",:html=>".html",:txtl=>".rhtml",:tm=>".tm",:tex=>".tex",:odt_content=>"_content.xml",:odt_styles=>"_styles.xml",:dyn=>".dynout",:ttm=>"_ttm.xml"}
+
+  def Dyndoc.mode
+    @@mode
+  end
+
+  def Dyndoc.mode=(mode)
+    @@mode=mode
+  end
+
+  def Dyndoc.docExt(mode=@@mode)
+    @@docExt[mode]
+  end
+
+  def Dyndoc.tmplExt
+    @@tmplExt
+  end
+
+
+  def Dyndoc.init_dyndoc_library_path
+
+    [File.join(FileUtils.pwd,".dyndoc_library_path"),File.join(FileUtils.pwd,"dyndoc_library_path.txt"),File.join(@@cfg_dir[:etc],"dyndoc_library_path")].each do |dyndoc_library_path|
+      if File.exists? dyndoc_library_path
+        path=File.read(dyndoc_library_path).strip
+        path=path.split(Dyndoc::PATH_SEP).map{|pa| File.expand_path(pa)}.join(Dyndoc::PATH_SEP)
+        if !ENV["DYNDOC_LIBRARY_PATH"] or ENV["DYNDOC_LIBRARY_PATH"].empty?
+          ENV["DYNDOC_LIBRARY_PATH"]= path 
+        else
+          ENV["DYNDOC_LIBRARY_PATH"] += Dyndoc::PATH_SEP + path
+        end
+      end
+
+    end
+
+  end
+
+  def Dyndoc.setRootDoc(rootDoc,root,before=true)  
+    if rootDoc
+      if before
+        rootDoc2 = "#{root}:"+rootDoc
+     else
+        rootDoc2 = rootDoc+":#{root}"
+      end
+    else
+      rootDoc2=root 
+    end
+    #insure unique path and adress of rootDoc is unchanged!
+    rootDoc.replace(rootDoc2.split(":").uniq.join(":")) if rootDoc2
+  end
+
+  def Dyndoc.guess_mode(filename)
+    @@tmplExt.keys.map{|k| k.to_s}.sort.each do |ext|
+      return ext.to_sym if filename =~ /(#{@@tmplExt[ext.to_sym].join("|")})$/
+    end
+    return nil
+  end
+
+  def Dyndoc.init_rootDoc
+    rootDoc=""
+    if File.directory?(path=File.join(@@cfg_dir[:etc],Dyndoc.cfg_dyn['etc_path_subdir']))
+      Dir[File.join(path,"*")].sort.each do |pa|
+        rootDoc += (rootDoc.empty? ? "" : ":") + File.read(pa).chomp 
+      end
+    end
+    Dyndoc.cfg_dyn['root_doc']=rootDoc
+  end
+
+# append or alias tricks ##########################
+  @@append=nil
+
+  def Dyndoc.appendVar
+    @@append
+  end
+
+  def Dyndoc.make_append
+    ## global aliases
+    @@append={}
+    tmp=[]
+    sys_append=File.join( @@cfg_dir[:etc],"alias")
+    tmp += File.readlines(sys_append) if File.exists? sys_append 
+    home_append=File.join(@@cfg_dir[:etc],'alias')
+    tmp += File.readlines(home_append)  if File.exists? home_append
+    file_append=File.join(@@cfg_dir[:file],'.dyn_alias')
+    tmp += File.readlines(file_append)  if File.exists? file_append
+    tmp.map{|l| 
+      if l.include? ">"
+        l2=l.strip
+        unless l2.empty?
+          l2=l2.split(/[=>,]/).map{|e| e.strip} 
+          @@append[l2[0]]=l2[-1]
+        end
+      end
+    }
+  end
+
+  ## more useable than this !!!   
+  def Dyndoc.absolute_path(filename,pathenv)
+#puts "ici";p filename
+    return filename if File.exists? filename
+    paths=pathenv##.split(":")
+#puts "absolute_path:filname";p filename
+    name=nil
+    paths.each{|e| 
+      f=File.expand_path(File.join([e,filename]))
+#p f
+      if (File.exists? f)
+      	name=f
+      	break
+      end
+    }
+#puts "->";p name
+    name
+  end
+
+  def Dyndoc.directory_tmpl?(name,exts=@@tmplExt[@@mode])
+    if name and File.directory? name
+#puts "directory_tmpl?:name";p name;p exts
+#p File.join(name,"index")
+      resname=Dyndoc.doc_filename(File.join(name,"index"),exts,false)
+      resname=Dyndoc.doc_filename(File.join(name,File.basename(name,".*")),exts,false) unless resname
+
+##IMPORTANT: this file could not depend on the format_doc because it is related to the template and not the document!!!
+      resname=Dyndoc.doc_filename(File.join(@@cfg_dir[:root_path],["root","Default","index"]),exts,false) unless resname
+      name=resname
+    end
+#puts "directory_tmpl?:return resname";p resname;p name
+    return name
+  end
+
+  PATH_SEP=";"
+
+  def Dyndoc.init_pathenv
+    #p Dyndoc.cfg_dyn
+      if Dyndoc.cfg_dyn[:dyndoc_mode]==:normal #normal mode
+         pathenv="."
+      else #client server mode
+        #puts "working directory";p Dyndoc.cfg_dyn[:working_dir]
+        pathenv = Dyndoc.cfg_dyn[:working_dir] + PATH_SEP + "."
+      end
+      return pathenv
+  end
+
+
+  def Dyndoc.ordered_pathenv(pathenv)
+    path_ary=[]
+    pathenv.split(PATH_SEP).each{|e| 
+      if e=~/(?:\((\-?\d*)\))(.*)/ 
+        path_ary.insert($1.to_i-1,$2.strip)
+      else 
+        path_ary << e.strip
+      end
+    }
+    #puts "path_ary";p path_ary
+    path_ary.compact.uniq #.join(":")
+  end
+
+  ## dynamically get pathenv!!!!
+  def Dyndoc.get_pathenv(rootDoc=nil,with_currentRoot=true)
+    pathenv =  Dyndoc.init_pathenv
+    pathenv += PATH_SEP + File.join(@@dyn_gem_path,"dyndoc") + PATH_SEP + File.join(@@dyn_gem_path,"dyndoc","Std") if File.exists? File.join(@@dyn_gem_path,"dyndoc")
+    # high level of priority since provided by user
+    pathenv += PATH_SEP + ENV["DYNDOC_LIBRARY_PATH"] if ENV["DYNDOC_LIBRARY_PATH"] and !ENV["DYNDOC_LIBRARY_PATH"].empty?
+    pathenv += PATH_SEP + File.join(Dyndoc.cfg_dir[:root_path],"library") if File.exists? File.join(@@cfg_dir[:root_path],"library")
+    pathenv += PATH_SEP + @@cfg_dir[:current_doc_path] if with_currentRoot and !@@cfg_dir[:current_doc_path].empty?
+    pathenv += PATH_SEP + rootDoc  if rootDoc and !rootDoc.empty?
+    pathenv += PATH_SEP + Dyndoc.cfg_dyn[:root_doc]  unless Dyndoc.cfg_dyn[:root_doc].empty?
+    pathenv += PATH_SEP + ENV["TEXINPUTS"].split(RUBY_PLATFORM =~ /mingw/ ? ";" : ":" ).join(";") if ENV["TEXINPUTS"] and @@mode==:tex
+    
+    ##Dyndoc.warn "pathenv",pathenv
+    return Dyndoc.ordered_pathenv(pathenv)
+  end
+  
+  # if exts is a Symbol then it is the new @@mode!
+  def Dyndoc.doc_filename(filename,exts=@@tmplExt[@@mode],warn=true,pathenv=".",rootDoc=nil)
+    rootDoc=Dyndoc.cfg_dyn[:root_doc] unless Dyndoc.cfg_dyn[:root_doc].empty?
+    filename=filename.strip
+    if exts.is_a? Symbol
+      @@mode=exts 
+      exts=@@tmplExt[@@mode]
+    end
+     
+    pathenv = Dyndoc.get_pathenv(rootDoc)
+    exts = exts + @@tmplExt.values.flatten  #if @cfg[:output]
+    exts << "" #with extension
+#puts "before finding paths";p filename;p @@mode;p exts
+    exts.uniq!
+    names=exts.map{|ext| Dyndoc.absolute_path(filename+ext,pathenv)}.compact
+    name=(names.length>0 ? names[0] : nil)
+    if warn
+      print "WARNING: #{filename}  with extension #{exts.join(',')} not reachable in:\n #{pathenv.join(':')}\n" unless name
+      #puts "tmpl:";p name
+    end
+    return name
+  end
+
+
+  def Dyndoc.input_from_file(filename)
+    return Dyndoc.read_content_file(Dyndoc.doc_filename(filename))
+  end
+
+  # the filename path has to be complete
+  def Dyndoc.read_content_file(filename,aux={})
+#p filename
+    case File.extname(filename)
+    when ".odt"
+      odt=Dyndoc::Odt.new(filename)
+      aux[:doc].inputs={} unless aux[:doc].inputs 
+      aux[:doc].inputs[filename]= odt unless aux[:doc].inputs[filename]
+      odt.body_from_content
+    else
+      File.read(filename)
+    end
+  end
+
+  #find the name of the template when mode is given
+  def Dyndoc.name_tmpl(name,mode=:all)
+    #clean dtag
+    dtags=[:dtag] #update if necessary
+    dtag=name.scan(/(?:#{dtags.map{|e| "_#{e}_" }.join("|")})/)[0]
+    if dtag
+      name=name.gsub(/(?:#{dtags.map{|e| "_#{e}_" }.join("|")})/,"")
+    end
+#puts "name";p name
+    #file exists?
+    if File.exists? name
+      return name
+    elsif name.scan(/([^\.]*)(#{@@tmplExt.map{|e| e[1]}.flatten.uniq.map{|e| Regexp.escape(e)}.join("|")})+$/)[0]
+      pathenv=Dyndoc.get_pathenv(Dyndoc.cfg_dyn[:root_doc],false) #RMK: do not know if false really matters here (introduced just in case in get_pathenv!!!) 
+#puts "pathenv";p pathenv; p Dyndoc.absolute_path(name,pathenv)
+      return Dyndoc.absolute_path(name,pathenv)
+    else
+      return Dyndoc.doc_filename(name,@@tmplExt[mode],true)
+    end
+  end
+
+  def Dyndoc.make_dir(dir)
+    tmp=File.expand_path(dir)
+    FileUtils.mkdir_p(tmp) unless File.exists? tmp
+  end
+
+end