asciidoctor-latex 1.5.0.3.dev → 1.5.0.4.dev

data/lib/asciidoctor/latex/core_ext/utility.rb

@@ -0,0 +1,55 @@
+
+
+class String
+
+  # This method allows one to compute
+  # the strings that represent LaTeX
+  # macro applicatins without descent
+  # into a hell of backlslshes and braces,
+  # especially when more than one macro
+  # has to be applied.  For example,
+  # instead of
+  #
+  #    content = "\\roleblue\{ #{content}\}"
+  #
+  # we say just
+  #
+  #    content = content.macro('roleblue')
+  #
+  # Here is an appication of three macros:
+  #
+  #    content.macro('roleblue').macro('foo').macro('bar')
+  #
+  #
+  def macro(macro)
+    "\\#{macro}\{#{self}\}"
+  end
+
+  #   The 'apply_macros' method simplifies the
+  #   chaining of a sequence of macro applications.
+  #   For example, we could say
+  #
+  #   'yoda'.macro('baz').macro('bar').macro('foo')
+  #
+  #         => "\\foo{\\bar{\\baz{yoda}}}"
+  #
+  #   But it is simpler to say
+  #
+  #   'yoda'.apply_macros(['foo', 'bar', 'baz'])
+  #
+  #       => "\\foo{\\bar{\\baz{yoda}}}"
+  #
+  #   Because we reverse the argument list, the
+  #   application order of the LaTeX macros
+  #   matches the order in the argument list.
+
+  def apply_macros(macro_list)
+    val = self
+    macro_list.reverse.each do |macro_name|
+      val = val.macro(macro_name)
+    end
+    val
+  end
+
+
+end

data/lib/asciidoctor/latex/css.rb

@@ -0,0 +1,50 @@
+require 'asciidoctor'
+
+require 'asciidoctor/extensions' unless RUBY_ENGINE == 'opal'
+
+include ::Asciidoctor
+
+
+# The following docinfo processor permits the converter to
+# read an additional style file (extras.css in the data directory).
+# The docinfo extension is registered in the converter.rb:
+#
+#   Asciidoctor::Extensions.register do
+#     docinfo_processor CSSDocinfoProcessor
+#     ..
+#   end
+#
+
+class CSSDocinfoProcessor < Asciidoctor::Extensions::DocinfoProcessor
+
+  use_dsl
+  at_location :header
+
+
+  def process doc
+    extdir = File.expand_path("../../../../data", __FILE__)
+    stylesheet_name = 'extras.css'
+    if doc.attr? 'linkcss'
+      stylesheet_href = handle_stylesheet doc, extdir, stylesheet_name
+      %(<link rel="stylesheet" href="#{stylesheet_href}">)
+    else
+      content = doc.read_asset %(#{extdir}/#{stylesheet_name})
+      ['<style>', content.chomp, '</style>'] * "\n"
+    end
+  end
+
+  def handle_stylesheet doc, extdir, stylesheet_name
+    outdir = (doc.attr? 'outdir') ? (doc.attr 'outdir') : (doc.attr 'docdir')
+    stylesoutdir = doc.normalize_system_path((doc.attr 'stylesdir'), outdir, (doc.safe >= SafeMode::SAFE ? outdir : nil))
+    if stylesoutdir != extdir && doc.safe < SafeMode::SECURE && (doc.attr? 'copycss')
+      destination = doc.normalize_system_path stylesheet_name, stylesoutdir, (doc.safe >= SafeMode::SAFE ? outdir : nil)
+      content = doc.read_asset %(#{extdir}/#{stylesheet_name})
+      ::File.open(destination, 'w') {|f|
+        f.write content
+      }
+      destination
+    else
+      %(./#{stylesheet_name})
+    end
+  end
+end

data/lib/asciidoctor/latex/environment_block.rb

@@ -114,12 +114,15 @@ module Asciidoctor::LaTeX
       # Use the option set if present (numbered, no+_number) otherwise
       # use a default value, e.g. 'box' is not numbered, the others are numbered
       if !(attrs['options'] =~ /no_number|numbered/)
-        if %w(box).include? role
+        if %w(capsule box equation equationalign).include? role
           attrs['options'] = 'no_number'
         else
           attrs['options'] = 'numbered'
         end
       end
+      if attrs['id']
+        attrs['options'] = 'numbered'
+      end
 
 
       # Adjust title according to environment name
@@ -127,10 +130,15 @@ module Asciidoctor::LaTeX
       if %w(equation equationalign chem).include? role
         attrs['title'] = env_name
       elsif role == 'code'
-        attrs['title'] = 'Listing'
+        if attrs['id'] or attrs['title']
+          attrs['title'] = 'Listing'
+        else
+          attrs['title'] = ''
+          attrs['options'] = 'no_number'
+        end
       elsif role == 'jsxgraph'
         attrs['title'] = 'JSXGraph'
-      elsif role == 'box'
+      elsif role == 'box'or role == 'capsule'
         attrs['title'] = ''
       else
         attrs['title'] = env_name.capitalize
@@ -140,6 +148,7 @@ module Asciidoctor::LaTeX
 
       # Creat the block
       if attrs['role'] == 'code'
+        warn "for rode = code, attrs = #{attrs}".cyan
         block = create_block parent, :listing, reader.lines, attrs
       else
         block = create_block parent, :environment, reader.lines, attrs
@@ -164,7 +173,7 @@ module Asciidoctor::LaTeX
         attrs['caption-num'] = caption_num
         caption = "#{caption_num}"
         # Set the title, e.g., "Theorem 3: Pythagoras" or just "Theorem 3"
-        # depending on whether the user sets a title, .e.g, ".Pythgoras"
+        # depending on whether the user sets a title, .e.g, ".Pythagoras"
         # in the line preceding "[env.theorem]"
         if original_title
           attrs['title'] = "#{env_title} #{caption_num}: #{original_title}"
@@ -195,8 +204,6 @@ module Asciidoctor::LaTeX
       block.assign_caption caption
       if %w(equation equationalign chem).include? role
         block.title = "#{caption_num}"
-      elsif %w(box).include? role
-          block.title =  attrs['title']
       else
         block.title = attrs['title']
       end

data/lib/asciidoctor/latex/inject_html.rb

@@ -18,7 +18,8 @@ module Asciidoctor::LaTeX
   $click_insertion = <<EOF
 
 <style>
-  .click .title { color: blue; }'
+  .click .title { color: blue; }
+  .openblock>.box>.content { margin-top:1em;margin-bottom: 1em;margin-left:3em;margin-right:4em; }
 </style>
 
 

data/lib/asciidoctor/latex/node_processors.rb

@@ -1,5 +1,77 @@
 require 'asciidoctor'
 require 'asciidoctor/latex/core_ext/colored_string'
+require 'asciidoctor/latex/core_ext/utility'
+
+
+module TexUtilities
+
+  def self.macro(name, *args)
+    case args.count
+      when 1
+        "\\#{name}\{#{args[0]}\}"
+      when 2
+        "\\#{name}\{#{args[0]}\}\{#{args[1]}\}"
+      when 3
+        "\\#{name}\{#{args[0]}\}\{#{args[1]}\}\{#{args[2]}\}"
+      else
+        ''
+    end
+  end
+
+  # tex.region('bf', 'foo bar') => {\bf foo bar}
+  def self.region(name, arg)
+    "\{\\#{name} #{arg}\}"
+  end
+
+
+  def self.macro_opt(name, opt, args)
+    case args.count
+      when 1
+        "\\#{name}[#{opt}]\{#{args[0]}\}"
+      when 2
+        "\\#{name}[#{opt}]\{#{args[0]}\}\{#{args[1]}\}"
+      when 3
+        "\\#{name}[#{opt}]\{#{args[0]}\}\{#{args[1]}\}\{#{args[2]}\}"
+      else
+        ''
+    end
+  end
+
+  def self.apply_macros(macro_list, arg)
+    val = arg
+    macro_list.reverse.each do |macro_name|
+      val = self.macro(macro_name, val)
+    end
+    val
+  end
+
+  def self.begin(arg)
+    macro('begin', arg)
+  end
+
+  def self.end(arg)
+    macro('end', arg)
+  end
+
+  def self.env(env, *args)
+    case args.count
+      when 1
+        "#{self.begin(env)}\n#{args[0].strip}\n#{self.end(env)}\n"
+      when 2
+        "#{self.begin(env)}\{#{args[0]}\}\n#{args[1]}\n#{self.end(env)}\n"
+      when 3
+        "#{self.begin(env)}\{#{args[0]}\}\{#{args[1]}\}\n#{args[2]}\n#{self.end(env)}\n"
+      else
+        ''
+    end
+  end
+
+  def self.hypertarget(name, text)
+    "\\hypertarget\{#{name}\}\{#{text}\}"
+  end
+
+
+end
 
 
 # Yuuk!, The classes in node_processor implement the
@@ -8,6 +80,9 @@ require 'asciidoctor/latex/core_ext/colored_string'
 module Asciidoctor
 
 
+  include TexUtilities
+  $tex = TexUtilities
+
   class Document
 
     # Write preamble for tex file, write closing
@@ -29,17 +104,13 @@ module Asciidoctor
 
 
     def tex_process
-      # warn "Node: #{self.class}".blue if $VERBOSE
 
       doc = ''
 
-      # # warn "document.attributes['header'] = #{document.attributes['header']}".magenta if $VERBOSE
-
       unless embedded? or document.attributes['header']=='no'
         doc << "%% Preamble %%\n"
         if File.exist? 'preamble.tex'
           preamble = IO.read('preamble.tex')
-          # warn "preamble: #{preamble.length} chars".yellow
           doc << preamble << "\n "
         else
           doc << File.open(File.join(LaTeX::DATA_DIR, "preamble_#{self.document.doctype}.tex"), 'r') { |f| f.read }
@@ -50,13 +121,11 @@ module Asciidoctor
         # doc << File.open(File.join(LaTeX::DATA_DIR, 'macros.tex'), 'r') { |f| f.read }
         if File.exist? 'macros.tex'
           macros = IO.read('macros.tex')
-          # warn "macros: #{macros.length} chars".yellow
           doc << macros
         else
           # warn "Could not find file macros.tex".yellow
         end
         if File.exist?('myEnvironments.tex')
-          # warn "I will take input from myEnvironments.tex".blue
           doc << "\\input myEnvironments.tex\n"
         else
           # warn "I will take input from newEnvironments.tex".blue
@@ -84,11 +153,9 @@ module Asciidoctor
       unless embedded?
         # Now write the defnitions of the new environments
         # discovered to file
-        # warn "Writing environment definitions to file: newEnvironments.tex" if $VERBOSE
         definitions = ""
 
         $latex_environment_names.uniq.each do |name|
-          # warn name if $VERBOSE
           definitions << "\\newtheorem\{#{name}\}\{#{name.capitalize}\}" << "\n"
         end
 
@@ -107,7 +174,6 @@ module Asciidoctor
   class Section
 
     def tex_process
-      # warn ["Node:".blue, "section[#{self.level}]:".cyan, "#{self.title}"].join(" ") if $VERBOSE
       doctype = self.document.doctype
 
       tags = { 'article' => [ 'part',  'section', 'subsection', 'subsubsection', 'paragraph' ],
@@ -115,8 +181,11 @@ module Asciidoctor
 
       tagname = tags[doctype][self.level]
       tagsuffix = self.numbered ? '' : '*'
-
-      "\\#{tagname}#{tagsuffix}\{#{self.title}\}\n\n#{self.content}\n\n"
+      id ="_#{self.title.downcase.gsub(' ', '_')}"
+      heading = "\\#{tagname}#{tagsuffix}\{#{self.title}\}"
+      heading = $tex.hypertarget id, heading
+      value = "#{heading}\n#{self.content}"
+      value
     end
   end
 
@@ -127,7 +196,6 @@ module Asciidoctor
   class List
 
     def tex_process
-      # warn ["Node:".blue, "#{self.node_name}[#{self.level}]".cyan, "#{self.content.count} items"].join(" ") if $VERBOSE
       case self.node_name
       when 'dlist'
         dlist_process
@@ -135,8 +203,6 @@ module Asciidoctor
         ulist_process
       when 'olist'
         olist_process
-      when 'colist'
-        colist_process
       else
         # warn "This Asciidoctor::List, tex_process.  I don't know how to do that (#{self.node_name})" if $VERBOSE
       end
@@ -162,7 +228,6 @@ module Asciidoctor
     def ulist_process
       list = "\\begin{itemize}\n\n"
       self.content.each do |item|
-        # warn ["  --  item: ".blue, "#{item.text.split("\n").first}"].join(" ") if $VERBOSE
         list << "\\item #{item.text}\n\n"
         list << item.content
       end
@@ -172,17 +237,12 @@ module Asciidoctor
     def olist_process
       list = "\\begin{enumerate}\n\n"
       self.content.each do |item|
-        # warn ["  --  item:  ".blue, "#{item.text.split("\n").first}"].join(" ") if $VERBOSE
-        list << "\\item #{item.text}\n\n"
+        list << item.text.macro('item') << "\n\n"
         list << item.content
       end
       list << "\\end{enumerate}\n\n"
     end
 
-    def colist_process
-      warn "Please implement me! (colist_process)".red if $VERBOSE
-    end
-
   end
 
   # Proces block elements of varios kinds
@@ -192,7 +252,6 @@ module Asciidoctor
     STANDARD_ENVIRONMENT_NAMES = %w(equation)
 
     def tex_process
-      # warn ["Node:".blue , "#{self.blockname}".blue].join(" ") if $VERBOSE
       case self.blockname
       when :paragraph
         paragraph_process
@@ -240,141 +299,247 @@ module Asciidoctor
 
 
     def paragraph_process
-      # warn "paragraph attributes: #{self.attributes}".red if $VERBOSE
+      options = self.attributes['options']
       out = ""
       if self.attributes['title']
-        out << "\{\\bf #{self.attributes['title']}\.}" << "\n"
+        title = "#{self.attributes['title']}\."
+        out << $tex.region('bf', title) + ' '
       end
-      out << LaTeX::TeXPostProcess.make_substitutions(self.content) << "\n\n"
+      content =  LaTeX::TeXPostProcess.make_substitutions(self.content)
+      if role == "red"
+        content = content.macro('rolered')
+      elsif role == "blue"
+        content = content.macro('roleblue')
+      end
+      if options and options.include? 'hardbreaks'
+        # content =  content.macro('obeylines')
+      end
+
+      out << content << "\n\n"
     end
 
     def stem_process
-      # warn ["Node:".blue, "#{self.blockname}".cyan].join(" ") if $VERBOSE
-      # warn self.content.cyan if $VERBOSE
       environment = LaTeX::TeXBlock.environment_type self.content
       if LaTeX::TeXBlock::INNER_TYPES.include? environment
-        out = "\\\[\n#{LaTeX::TeXPostProcess.stem_substitutions self.content}\n\\\]\n"
-        # warn out.yellow if $VERBOSE
-        out
+        "\\\[\n#{LaTeX::TeXPostProcess.stem_substitutions self.content}\n\\\]\n"
       else
         self.content
       end
     end
 
     def admonition_process
-      # warn ["Node:".blue, "#{self.blockname}".cyan, "#{self.style}:".magenta, "#{self.lines[0]}"].join(" ") if $VERBOSE
-      "\\admonition\{#{self.style}\}\{#{self.content}\}\n"
+      $tex.macro 'admonition', self.style, self.content
     end
 
     def page_break_process
-      # warn ["Node:".blue, "#{self.blockname}".cyan].join(" ") if $VERBOSE
       "\n\\vfill\\eject\n"
     end
 
     def literal_process
-      # warn ["Node:".magenta, "#{self.blockname}".cyan].join(" ") if $VERBOSE
-      "\\begin\{verbatim\}\n#{self.content}\n\\end\{verbatim\}\n"
+      heading = ''
+      if id and self.title
+        heading = $tex.hypertarget id, self.title
+      elsif self.title
+        heading = self.title
+      end
+      if heading == ''
+        $tex.env 'verbatim', self.content
+      else
+        output = $tex.region 'bf', heading
+        output << "\\vspace\{-1\\baselineskip\}\n"
+        output << ($tex.env 'verbatim', self.content)
+      end
     end
 
     def pass_process
-      # warn ["Node:".magenta, "#{self.blockname}".cyan].join(" ") if $VERBOSE
       self.content
     end
 
     def quote_process
-      # warn ["Node:".magenta, "#{self.blockname}".cyan].join(" ") if $VERBOSE
       if self.attr? 'attribution'
         attribution = self.attr 'attribution'
         citetitle = (self.attr? 'citetitle') ? (self.attr 'citetitle') : nil
-
-        "\\begin\{aquote\}{#{attribution}#{citetitle ? ' - ' + citetitle : ''}}\n#{self.content}\\end\{aquote\}\n"
+        # citetitle = citetitle ? ' - ' + citetitle : ''
+        citetitle = citetitle ? $tex.region('bf', citetitle) + ' \\\\' : ''
+        $tex.env 'aquote', attribution, citetitle, self.content
+      elsif self.title
+        $tex.env 'tquote', self.title, self.content
       else
-        "\\begin\{quote\}\n#{self.content}\\end\{quote\}\n"
+        $tex.env 'quotation', self.content
       end
     end
 
-    def environment_process
 
-      # warn "begin environment_process, ".blue + "title = #{self.title}".yellow if $VERBOSE
-      # warn "environment attributes = #{self.attributes}".red if $VERBOSE
-      # warn "role = #{self.attributes["role"]}" if $VERBOSE
 
-      env = self.attributes["role"]
-
-      # record any environments encountered but not built=in
-      if !STANDARD_ENVIRONMENT_NAMES.include? env and !$latex_environment_names.include? env
-      # if  !($latex_environment_names.include? env)
-        # warn "env added: [#{env}]".blue if $VERBOSE
-        $latex_environment_names << env
-      end
+ ####################################################################
 
+    def label
       if self.id
-        label = "\n\\label\{#{self.id}\}"
+        label = $tex.macro 'label', self.id
+        # label = $tex.macro 'label', $tex.hypertarget(self.id, self.id)
       else
         label = ""
       end
+      label
+    end
 
-      # warn "self.attributes['original_title'] = #{self.attributes['original_title']}".cyan if $VERBOSE
+    def options
+      self.attributes['options']
+    end
 
+    def env_title
       if self.attributes['original_title']
-        title = "\{\\rm (#{self.attributes['original_title']}) \}"
+        "\{\\rm (#{self.attributes['original_title']}) \}"
+      else
+        ''
+      end
+    end
+
+ ####################################################################
+
+    def handle_listing
+      content = $tex.env 'verbatim', self.content
+      $tex.env env, label, content
+    end
+
+    def handle_eqalign
+      if options.include? 'numbered'
+        content = $tex.env 'split', label + "\n" + self.content.strip
+        $tex.env 'equation', content
+      else
+        content = $tex.env 'split', label + "\n" + self.content.strip
+        $tex.env 'equation*', content
+      end
+    end
+
+    def handle_equation
+      if options.include? 'numbered'
+        content = $tex.hypertarget self.id, self.content.strip
+        $tex.env 'equation', "#{label}#{content}"
+      else
+        $tex.env 'equation*', "#{label}#{self.content.strip}"
+      end
+    end
+
+    def handle_chem
+      $tex.env 'equation', "#{label}\n\\ce\{#{self.content.strip}\}\n"
+    end
+
+    def handle_plain(env)
+
+      if self.id and self.title
+        _title = $tex.hypertarget self.id, self.env_title
       else
-        title = ''
+        _title = self.env_title
       end
 
-      if env == 'listing'
-        output = "\\begin\{#{env}\}#{label}\\begin{verbatim}\n\n#{self.content}\\end{verbatim}\n\\end\{#{env}\}\n"
-      elsif env == 'equationalign'
-        output = "\\begin\{equation\}#{label}\n\\begin\{split\}\n#{self.content}\n\\end\{split\}\n\\end\{equation\}\n"
-      elsif env == 'chem'
-        output = "\\begin\{equation\}#{label}\n\\ce\{#{self.content}\}\n\\end\{equation\}\n"
+      if self.attributes['plain-option']
+        content = $tex.region 'rm', self.content
       else
-        output = "\\begin\{#{env}\}#{title}#{label}\n#{self.content}\n\\end\{#{env}\}\n"
+        content = self.content
       end
 
+      $tex.env env, "#{_title}#{label}#{content}\n"
+    end
+
+ ####################################################################
 
+    def environment_process
 
-      output
+      env = self.attributes["role"]
 
+      # record any environments encountered but not built=in
+      if !STANDARD_ENVIRONMENT_NAMES.include? env and !$latex_environment_names.include? env
+        $latex_environment_names << env
+      end
+
+      case env
+        when 'listing'
+          handle_listing
+        when 'equationalign'
+          handle_eqalign
+        when 'equation'
+          handle_equation
+        when 'chem'
+          handle_chem
+        when 'box'
+          handle_box
+        when 'texmacro'
+          handle_texmacro
+        else
+          handle_plain(env)
+      end
     end
 
-    def click_process
+    def handle_texmacro
+      self.content
+    end
 
-      # warn "begin click_process".blue + "title = #{self.title}".yellow if $VERBOSE
+    def handle_box
+      if self.title.nil? or self.title == ''
+        $tex.env 'asciidocbox', self.content
+      else
+        $tex.env 'titledasciidocbox',  self.title, self.content
+      end
+    end
 
+    def click_process
+      attr = self.attributes
       click = self.attributes["role"]
-      # record any environments encounted but not built=in
+      # record any environ$ments encounted but not built=in
       if !STANDARD_ENVIRONMENT_NAMES.include? click
         $latex_environment_names << click
       end
 
-      ### XXX fixme:
-      click = 'note'
+      if title
+        title = self.title.downcase
+      end
 
-      if self.id == nil # No label
-        output = "\\begin\{#{click}\}\n#{self.content}\n\\end\{#{click}\}\n"
+      # original_title = title.split(' ')[0].downcase
+      # FIXME: the above is  work-around: instead set
+      # originaltitle in clickblock
+
+      if attr['plain-option']
+        content = $tex.region 'rm', self.content
       else
-        output = "\\begin\{#{click}\}\n\\label\{#{self.id}\}\n#{self.content}\\end\{#{click}\}\n"
+        content = $tex.region 'it', self.content
+      end
+
+      # FIXME! This is a temporary hack.
+      # attr['original_title'] can be nil --
+      # it shouldn't be
+      if attr['original_title']
+        if attr['options'] and attr['options'].include? 'numbered'
+          env = attr['original_title'].downcase
+        else
+          env =  attr['original_title'].downcase+'*'
+        end
+      else
+        env = 'click'
       end
 
-      # warn "end click_process\n".blue if $VERBOSE
 
-      output
 
+      if self.id == nil # No label
+        $tex.env env, content
+      else
+        label = $tex.macro 'label', self.id
+        $tex.env env, "#{label}\n#{content}"
+      end
     end
 
     def toc_process
-      warn "Please implement me! (toc_process)".red if $VERBOSE
+      # warn "Please implement me! (toc_process)".red if $VERBOSE
     end
 
     def report
       # Report on this node
-      # warn ["OPEN BLOCK:".magenta, "id: #{self.id}"].join(" ")
-      # warn ["Node:".magenta, "#{self.blockname}".cyan].join(" ")
-      # warn ["Attributes:".magenta, "#{self.attributes}".cyan].join(" ")
-      # warn ["Title: ".magenta, title.cyan, "style:", self.style].join(" ") if title
-      # warn ["Content:".magenta, "#{self.content}".yellow].join(" ")
-      # warn ["Style:".green, "#{self.style}".red].join(" ")
+      warn ["OPEN BLOCK:".magenta, "id: #{self.id}"].join(" ")
+      warn ["Node:".magenta, "#{self.blockname}".cyan].join(" ")
+      warn ["Attributes:".magenta, "#{self.attributes}".cyan].join(" ")
+      warn ["Title: ".magenta, title.cyan, "style:", self.style].join(" ") if title
+      warn ["Content:".magenta, "#{self.content}".yellow].join(" ")
+      warn ["Style:".green, "#{self.style}".red].join(" ")
       # warn ["METHODS:".red, "#{self.methods}".yellow].join(" ")
     end
 
@@ -400,53 +565,47 @@ module Asciidoctor
     #
     def open_process
 
-      report if $VERBOSE
-
       attr = self.attributes
 
-      # warn "attributes (open block): #{self.attributes}" if $VERBOSE
-
-
       # Get title !- nil or make a dummy one
       title = self.attributes["title"]
       if title == nil
         title = "Dummy"
       end
 
-
-
-
        # strip constructs like {counter:theorem} from the title
        title = title.gsub /\{.*?\}/, ""
        title = title.strip
 
       if attr['role'] == 'text-center'
-        "\\begin\{center\}\n#{self.content}\\end\{center\}"
+        $tex.env 'center', self.content
       else
         self.content
       end
 
-
     end
 
     def listing_process
-      # warn ["Node:".magenta, "#{self.blockname}".cyan].join(" ") if $VERBOSE
-      # warn "attributes: #{self.attributes}".cyan if $VERBOSE
       "\\begin\{verbatim\}\n#{self.content}\n\\end\{verbatim\}\n"
     end
 
     def example_process
-      # warn "exAmple_process".yellow
-      # warn ["Node:".magenta, "#{self.blockname}".cyan].join(" ") if $VERBOSE
-      # warn "attributes: #{self.attributes}".cyan if $VERBOSE
-      # self.content_model = :verbatim
-      # warn "content: #{self.content}".cyan if $VERBOSE
-      "\\begin\{verbatim\}\n#{self.content}\n\\end\{verbatim\}\n"
+      id = self.attributes['id']
+      if self.title
+        heading = $tex.region 'bf', self.title
+        content  = "-- #{heading}.\n#{self.content}"
+      else
+        content = self.content
+      end
+      if id
+        hypertarget = $tex.hypertarget id, self.content.split("\n")[0]
+        content = "#{hypertarget}\n#{content}" if id
+      end
+      $tex.env 'example', content
     end
 
 
     def floating_title_process
-      # warn ["Node:".blue, "section[#{self.level}]:".cyan, "#{self.title}"].join(" ") if $VERBOSE
       doctype = self.document.doctype
 
       tags = { 'article' => [ 'part',  'section', 'subsection', 'subsubsection', 'paragraph' ],
@@ -458,8 +617,6 @@ module Asciidoctor
     end
 
     def image_process
-      # warn ["IXX: Node:".magenta, "#{self.blockname}".cyan].join(" ")  if $VERBOSE
-      # warn "IXX: attributes: #{self.attributes}".cyan  if $VERBOSE
       if self.attributes['width']
         width = "#{self.attributes['width'].to_f/100.0}truein"
       else
@@ -467,19 +624,21 @@ module Asciidoctor
       end
       raw_image = self.attributes['target']
       if document.attributes['noteshare'] == 'yes'
-        # warn "IXX: extracting image name".red if $VERBOSE
         image_rx = /image.*original\/(.*)\?/
         match_data = raw_image.match image_rx
         if match_data
           image = match_data[1]
-          # warn "IXX: image name: #{image}".red if $VERBOSE
         else
           image = "undefined"
         end
       else
         image = raw_image
       end
-      caption =   "\\caption\{#{self.attributes['title']}\}"
+      if self.title and self.title != ''
+        caption =   "\\caption\{#{self.attributes['title']}\}"
+      else
+        caption = ''
+      end
       refs = self.parent.document.references  # [:ids]
       if self.attributes['align'] == 'center'
         align = '\\centering'
@@ -503,7 +662,11 @@ module Asciidoctor
       else
         position = '[h]'
       end
-      "\\begin{#{figure_type}}#{position}\{#{ftext_width}\}\n\\includegraphics[width=#{width}]{#{image}}\n#{caption}\n#{align}\n\\end{#{figure_type}}\n"
+      # pos_option = "#{figure_type}}#{position}"
+      # incl_graphics = $tex.macro_opt, "width=#{width}", image
+      # $tex.env figure_type, "#{pos_option}\{#{ftext_width}\}", incl_graphics,
+      #\n\\includegraphics[width=#{width}]{#{image}}\n#{caption}\n#{align}"
+      "\\begin{#{figure_type}}#{position}\{#{ftext_width}\}\n\\centering\\includegraphics[width=#{width}]{#{image}}\n#{caption}\n#{align}\n\\end{#{figure_type}}\n"
     end
 
     def preamble_process
@@ -512,17 +675,25 @@ module Asciidoctor
 
 
     def sidebar_process
-      # warn "sidebar_process".yellow if $VERBOSE
-      # warn ["Node:".magenta, "#{self.blockname}".cyan].join(" ") if $VERBOSE
-      # warn "attributes: #{self.attributes}".cyan if $VERBOSE
-      "\\begin\{sidebar\}\n#{self.content}\n\\end\{sidebar\}\n"
+      title = self.title
+      attr = self.attributes
+      id = attr['id']
+      if id
+        content = "\\hypertarget\{#{id}\}\{#{self.content}\}"
+      else
+        content = self.content
+      end
+      if title
+        title  = $tex.env 'bf', title
+        $tex.env 'sidebar', "#{title}\\\\#{content}"
+      else
+        $tex.env 'sidebar', content
+      end
     end
 
     def verse_process
-      # warn "verse_process".yellow if $VERBOSE
-      # warn ["Node:".magenta, "#{self.blockname}".cyan].join(" ") if $VERBOSE
-      # warn "attributes: #{self.attributes}".cyan if $VERBOSE
-      "\\begin\{alltt\}\n#{self.content}\n\\end\{alltt\}\n"
+      # $tex.env 'alltt', self.content
+      $tex.env 'verse', self.content
     end
 
   end # class Block
@@ -543,40 +714,52 @@ module Asciidoctor
       when 'inline_callout'
         self.inline_callout_process
       else
-        # warn "This is Asciidoctor::Inline, tex_process.  I don't know how to do that (#{self.node_name})".yellow if $VERBOSE
         ""
       end
     end
 
     def inline_quoted_process
-      # warn ["Node:".blue, "#{self.node_name}".cyan,  "type[#{self.type}], ".green + " text: #{self.text}"].join(" ") if $VERBOSE
+      warn "THIS IS: inline_quoted_process: #{self.type}"  if $VERBOSE
       case self.type
-      when :strong
-        #"\\textbf\{#{self.text}\}"
-        self.text
-      when :emphasis
-        "\\emph\{#{self.text}\}"
-      when :asciimath
-        "\$#{LaTeX::TeXPostProcess.stem_substitutions self.text}\$"
-      when :monospaced
-        "\{\\tt #{self.text}\}"
-      when :unquoted
-        role = self.attributes["role"]
-        # warn "  --  role = #{role}".yellow if $VERBOSE
-        if role == "red"
-          "\\rolered\{ #{self.text}\}"
+        when :strong
+          "\\textbf\{#{self.text}\}"
+        when :emphasis
+          "\\emph\{#{self.text}\}"
+        when :asciimath
+          output = Asciidoctor.convert( self.text, backend: 'html')
+          output
+        when :monospaced
+          "\\textt\{#{self.text}\}"
+        when :superscript
+          "$\{\}^{#{self.text}}$"
+        when :subscript
+          "$\{\}_{#{self.text}}$"
+        when :mark
+          "\\colorbox\{yellow\}\{ #{self.text}\}"
+        when :double
+          "``#{self.text}''"
+        when :single
+          "`#{self.text}'"
+        when :latexmath
+           "\\(#{LaTeX::TeXPostProcess.stem_substitutions self.text}\\)"
+          # output = Asciidoctor.convert self.text, {stem: 'asciimath', backend: 'html'}
+          self.text
+        when :unquoted
+          role = self.attributes["role"]
+          if role == "red"
+            "\\rolered\{ #{self.text}\}"
+          elsif role == "blue"
+            "\\roleblue\{ #{self.text}\}"
+          else
+            # warn "This is inline_quoted_process.  I don't understand role = #{role}" if $VERBOSE
+          end
         else
-          # warn "This is inline_quoted_process.  I don't understand role = #{role}" if $VERBOSE
-        end
-      else
-        "\\unknown\\{#{self.text}\\}"
+          "\\unknown\\{#{self.text}\\}"
       end
     end
 
     def inline_anchor_process
 
-      # warn ["Node:".blue, "#{self.node_name}".magenta,  "type[#{self.type}], ".green + " text: #{self.text} target: #{self.target}".cyan].join(" ") if $VERBOSE
-
       refid = self.attributes['refid']
       refs = self.parent.document.references[:ids]
       # FIXME: the next line is HACKISH (and it crashes the app when refs[refid]) is nil)
@@ -592,33 +775,27 @@ module Asciidoctor
         reftext = ""
       end
       case self.type
-      when :link
-        "\\href\{#{self.target}\}\{#{self.text}\}"
-      when :ref
-        "\\label\{#{self.text.gsub(/\[(.*?)\]/, "\\1")}\}"
-      when :xref
-        #"\\ref\{#{self.target.gsub('#','')}\}"
-        # # warn "\\hyperlink\{#{refid}\}\{#{reftext}\}".yellow
-        "\\hyperlink\{#{refid}\}\{#{reftext}\}"
-      else
-        # warn "!!  : undefined inline anchor -----------".magenta if $VERBOSE
+        when :link
+          $tex.macro 'href', self.target, self.text
+        when :ref
+          $tex.macro 'label', self.text.gsub(/\[(.*?)\]/, "\\1")
+        when :xref
+          $tex.macro 'hyperlink', refid, reftext
+        else
+          # warn "!!".magenta if $VERBOSE
       end
     end
 
     def inline_break_process
-      # warn ["Node:".blue, "#{self.node_name}".cyan,  "type[#{self.type}], ".green + " text: #{self.text}"].join(" ") if $VERBOSE
       "#{self.text} \\\\"
     end
 
     def inline_footnote_process
-      # warn ["Node:".blue, "#{self.node_name}".cyan,  "type[#{self.type}], ".green + " text: #{self.text}"].join(" ") if $VERBOSE
-      # # warn self.content.yellow
-      # # warn self.style.magenta
-      "\\footnote\{#{self.text}\}"
+      $tex.macro 'footnote', self.text
     end
 
     def inline_callout_process
-      warn "Please implement me! (inline_callout_process)".red if $VERBOSE
+      # warn "Please implement me! (inline_callout_process)".red if $VERBOSE
     end
 
   end