asciidoctor-latex 1.5.0.dev

data/lib/asciidoctor/latex/prepend_processor.rb

@@ -0,0 +1,36 @@
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+
+module Asciidoctor::LaTeX
+
+  # THIS CLASS IS NO LONGER USED
+  # Prepend lines to a document
+
+  class ClickStyleInsert < Asciidoctor::Extensions::Preprocessor
+
+    def putline line
+      @@line_array += [line, ""]
+    end
+
+    def process document, reader
+
+      warn "Entering ClickStyleInsert".magenta
+
+      @@line_array = []
+
+      return reader if reader.eof?
+
+      putline '++++'
+      putline '<style>'
+      putline '.click .title { color: blue; }'
+      putline '</style>'
+      putline '++++'
+
+      reader.unshift_lines @@line_array
+      reader
+    end
+
+  end
+
+
+end

data/lib/asciidoctor/latex/preprocess.rb

@@ -0,0 +1,37 @@
+# DEFUNCT CODE?
+#
+# I think this is defunct code -- will investigate
+#
+
+# For trying things out
+# Call the input file foo.in
+# Then execute
+#
+#   $ ruby preprocess foo
+#
+# Currently output is directed to the
+# console.  Uncomment the last line
+# to direct output to foo.out
+
+require 'asciidoctor/latex/tex_block'
+
+
+base_name = ARGV[0]
+input_file = base_name + ".in"
+output_file = base_name + "out"
+
+input = File.open(input_file, 'r') { |f| f.read }
+
+puts "input:"
+puts "-----------------"
+puts input
+puts "-----------------\n\n"
+
+output = Asciidoctor::LaTeX::TeXBlock.process_environments input
+
+puts "output:"
+puts "-----------------"
+puts output
+puts "-----------------\n\n"
+
+# File.open(output_file, 'w') {|f| f.write(output) }

data/lib/asciidoctor/latex/tex_block.rb

@@ -0,0 +1,108 @@
+# This is for the latex backend
+# I have to review what the f the function
+# of this code is -- still used??
+#
+# I believe the point here is that
+# usage of [env.equation] etc
+# obviates the need for this code.
+#
+# To be continued @jxxcarlson
+
+
+#
+# The purpose of the module TeXBlock is to
+# transform structures of the form
+# \[ ... \], either by passing them on unchanged
+# or by stripping away the escaped braces.
+#
+# When ... is an environment such as
+#
+#     \begin{equation} ### \end{equation}
+#
+# the escaped braces must be stripped.
+# All other cases, as far as I know now (not far:-),
+# the braces remain.
+#
+# For the moment the solution is to strip when
+# the contents ... contain no string of the form
+# \begin{XXX} except for the cases in which XXX is
+#
+#    - array
+#    - matrix
+#
+# I believe that the list of these keywords is small,
+# whereas the number of other environments is large
+# and essentially unbounded, since users can define
+# their own environments.
+#
+module Asciidoctor::LaTeX
+  module TeXBlock
+
+    # Find blocks delmited by \[ ... \]
+    def self.get_tex_blocks str
+      rx_tex_block = /(\\\[)(.*?)(\\\])/m
+      str.scan rx_tex_block
+    end
+
+
+    # Return the environment type of a tex block.
+    # Thus, if str = \[\begin{foo} ho ho ho \end{foo}\],
+    # the string "foo" is returned.
+    def self.environment_type str
+      rx_env_block = /\\begin\{(.*?)\}/
+      m = str.match rx_env_block
+      if m
+        env_type = m[1]
+      else
+        env_type = 'none'
+      end
+      env_type
+    end
+
+    # Return the environment type from an
+    # element of the array produced by
+    # get_tex_blocks -- each element is a
+    # three-element array with the tex block
+    # as the middle element.
+    def self.environmemt_type_of_match m
+      environment_type m[1]
+    end
+
+    # Return the block as-is -- do not
+    # strip delimiters.
+    def self.restore_match_data m
+      m.join()
+    end
+
+    # Return the block sans delimiters
+    def self.strip_match_data m
+      m[1]
+    end
+
+    # Transform the input string for a given block m
+    def self.process_tex_block m, str
+      block_type = environmemt_type_of_match m
+      if INNER_TYPES.include? block_type
+        output = str
+      else
+        output = str.gsub restore_match_data(m), strip_match_data(m)
+      end
+      output
+    end
+
+    # Transform the input string by stripping or
+    # passing each tex block as required
+    def self.process_environments str
+      tbs = get_tex_blocks str
+      tbs.each do |tb|
+        str = process_tex_block tb, str
+      end
+      str
+    end
+
+    # The list of "inner environments" whose enclosing
+    # escaped braces are not to be stripped.
+    INNER_TYPES = ["array", "matrix",  "none"]
+
+  end
+end

data/lib/asciidoctor/latex/tex_postprocessor.rb

@@ -0,0 +1,44 @@
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+
+# a postprocessor to map the nonsense
+# string 'DOLLOD' back to '$'
+#
+# This is used in for the LaTeX backend
+# in conjunction with the code
+# in 'tex_preprocessor' which maps '\$' to
+# 'DOLLOD'
+#
+# There should be a better solution to the
+# vexing proble of dealing with both $ ... $
+# for mathematics and '\$' for currency. But
+# this works and wil have to do for now.
+#
+# @jirutka: Advice?
+#
+module Asciidoctor::LaTeX
+  # Map @@DOLLAR: to \$
+  class TexPostprocessor < Asciidoctor::Extensions::Postprocessor
+
+    def process document, output
+      output = output.gsub('DOLLOD', '\$')
+      output = output.gsub('CHEMRIGHTARROW','->').gsub('CHEMLEFTARROW','<-').gsub('CHEMLEFTRIGHTARROW','<-->')
+      output.gsub('!!!BACKSLASH', '\\')
+    end
+
+  end
+
+  class HTMLPostprocessor < Asciidoctor::Extensions::Postprocessor
+
+    def process document, output
+      output = output.gsub('\DOLLOD', '\$')
+      # match_data = output.match /%%(.*)%%/
+      # if match_data
+      #  output = output.gsub(match_data[0], match_data[1])
+      # end
+      output = output.gsub('DOLLOD', '$')
+      output.gsub('!!!BACKSLASH', '\\')
+    end
+
+  end
+end

data/lib/asciidoctor/latex/tex_preprocessor.rb

@@ -0,0 +1,65 @@
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+
+# Map $ ... $ to \(..\) before
+# running Asciidoctor, and map
+# '\$' to 'DOLLOD'.  The latter
+# will be mapped back to '$'
+# for the HTML backend by the
+# postprocessor in 'dollar.rb' and
+# to '\$' by the postprocessor
+# in 'escape_dollar.rb'
+#
+# The remaining substitutions will
+# be eliminated when I edit the
+# relevant source files on noteshare.
+
+module Asciidoctor::LaTeX
+  class TeXPreprocessor < Asciidoctor::Extensions::Preprocessor
+
+    # Map $...$ to stem:[...]
+    # TEX_DOLLAR_RX = /(^|\s|\()\$(.*?)\$($|\s|\)|,|\.)/
+    # TEX_DOLLAR_SUB = '\1latexmath:[\2]\3'
+    # TEX_DOLLAR_SUB = '\1\\\(\2\\\)\3'
+
+    TEX_DOLLAR_RX = /\$(.*?)\$/
+    TEX_DOLLAR_SUB = '\\\(\1\\\)'
+    TEX_DOLLAR_SUB2 = '+\\\(\1\\\)+'
+
+
+    def process document, reader
+      return reader if reader.eof?
+      replacement_lines = reader.read_lines.map do |line|
+        # (line.include? '$') ? (line.gsub TEX_DOLLAR_RX, TEX_DOLLAR_SUB) : line
+        if line.include? '<-->' and document.basebackend? 'tex'
+          line = line.gsub('<-->', 'CHEMLEFTRIGHTARROW')
+        end
+        if line.include? '->' and document.basebackend? 'tex'
+          line = line.gsub('->', 'CHEMRIGHTARROW')
+        end
+        if line.include? '<-' and document.basebackend? 'tex'
+          line = line.gsub('<-', 'CHEMLEFTARROW')
+        end
+        if line.include? '\$' and document.basebackend? 'html'
+          line = line.gsub '\$', 'DOLLOD'
+        end
+        if line.include? '%' and document.basebackend? 'tex'
+          line = line.gsub '%', '\%'
+        end
+        if line.include? '$'
+          line = line.gsub TEX_DOLLAR_RX, TEX_DOLLAR_SUB2
+        end
+        if line.include? '\\['
+          line = line.gsub '\\[', '+\\['
+        end
+        if line.include? '\\]'
+          line = line.gsub '\\]', '\\]+'
+        end
+        line
+      end
+      reader.unshift_lines replacement_lines
+      reader
+    end
+
+  end
+end

data/lib/asciidoctor/latex/version.rb

@@ -0,0 +1,5 @@
+module Asciidoctor
+  module LaTeX
+    VERSION = '1.5.0.dev'
+  end
+end

data/manual.adoc

@@ -0,0 +1,285 @@
+= LaTeX Converter Manual
+James Carlson
+:toc2:
+:numbered:
+:stem: latexmath
+
+== Introduction
+
+TexConverter translates a file written
+in a subset of Asciidoc to LaTeX.  The
+subset is described below.  While not
+complete, it is adequate for the preparation
+of a wide range of mathematical documents,
+from one-page handouts to articles to entire books.
+
+As a demonstration of the current state of this
+project, the file you are looking at, `manual.adoc`,
+can be rendered into HTML by
+----
+  $ asciidoctor manual.adoc
+----
+or can be rendered as a LaTeX file via
+----
+  $ asciidoctor-latex manual.adoc
+  # => manual.tex
+----
+The `.tex` file can in turn be rendred into pdf via
+`pdflatex`.
+
+
+Mathematical text in Asciidoc can be written as
+one usually does in LaTeX if one invokes the
+latex option.footnote:[This option exists but has not yet been released.  To use
+	the option at http://noteshare.io[noteshare.io], include the code `:latex:` in
+	your document].  You do this via  `asciidoctor -latex foo.adoc`.
+Thus for the Pythagorean
+theorem $a^2  + b^2 = c^2$, one writes
+
+----
+    $ a^2 + b^2 = c^2 $
+----
+
+For the famous formula of Euler,
+\[
+  e^{2\pi \sqrt{-1}} = 1
+\]
+one writes
+
+----
+\[
+  e^{2\pi \sqrt{-1}} = 1
+\]
+----
+
+
+== The Asciidoc-LaTeX subset
+
+
+
+=== Sections, levels 1 through 5
+
+
+=== Ordered and unordered lists
+
+In Asciidoc, an unordered list like
+
+* Pay Bills
+* Get Groceries
+** Milk
+** Bread
+** Orange Juice
+* Change Oil Filter on Car
+
+is written like this
+
+----
+    * Pay Bills
+    * Get Groceries
+    ** Milk
+    ** Bread
+    ** Orange Juice
+    * Change Oil Filter on Car
+----
+
+Its translation into LaTeX is
+
+----
+   \begin{itemize}
+   \item Pay Bills
+   \item Get Groceries
+   \begin{itemize}
+       \item Milk
+       \item Bread
+       \item Orange Juice
+   \end{itemize}
+   \item Change Oil Filter on Car
+   \end{itemize}
+----
+
+The corresponding ordered list,
+
+. Pay Bills
+. Get Groceries
+.. Milk
+.. Bread
+.. Orange Juice
+. Change Oil Filter on Car
+
+is written as
+
+----
+   . Pay Bills
+   . Get Groceries
+   .. Milk
+   .. Bread
+   .. Orange Juice
+   . Change Oil Filter on Car
+----
+
+with the following source in LaTex:
+
+----
+	\begin{enumerate}
+	\item Pay Bills
+	\item Get Groceries
+    \begin{enumerate}
+	    \item Milk
+	    \item Bread
+	    \item Orange Juice
+	\end{enumerate}
+	\item Change Oil Filter on Car
+	\end{enumerate}
+----
+
+=== Bold, italic, and monospaced text
+
+The text "She said _potatoes_ but he said *potaatoes*", written
+in Asciidoc as
+
+----
+    She said _potatoes_ but he said *potaatoes*
+----
+is mapped to
+
+----
+    She said \emph{potatoes} but he said \textbf{potaatoes}
+----
+
+The text
+
+----
+    `monospaced`
+----
+
+is mapped to
+
+----
+    {\tt monospaced}
+----
+
+
+=== Quotations
+
+The text
+
+----
+    [quote, Abraham Lincoln, Soldiers' National Cemetery Dedication]
+    ____
+    Four score and seven years ago our fathers brought forth
+    on this continent a new nation
+    ____
+----
+is mapped to
+
+----
+    \begin{quote}
+      Four score and seven years ago our fathers brought forth
+      on this continent a new nation
+    \end{quote}
+----
+
+=== Footnotes
+
+Text like this
+----
+    Ho hum.footnote:[An epression of boredem]
+----
+is mapped to
+
+----
+    Ho hum\footnote{An epression of boredem}
+----
+
+=== References and labels
+
+The label
+
+----
+    Ho hum[[foo]]
+----
+
+is mapped to
+
+----
+    Ho hum\label{foo}
+----
+
+The cross-reference
+
+----
+    Please see <<foo>>
+----
+
+is mapped to
+
+----
+   Please see \ref{foo}
+----
+
+
+
+=== Hyperlinks
+
+The hyperlink
+
+----
+    http://nytimes.com[All the news that is fit to print]
+----
+
+is mapped to
+
+----
+   \href{http://nytimes.com}{All the news that is fit to print}
+----
+
+=== Line breaks `+`
+
+=== Listing
+
+=== Open blocks
+
+=== Literal
+
+=== Page break
+
+=== Pass
+
+////
+  INLINE_TYPES = %w( inline_quoted)
+  BLOCK_TYPES = %w(admonition listing literal page_break paragraph stem pass open quote)
+////
+
+
+== Mathematical text
+
+We distinguish between _inner text_ amd _outer text_.  the first
+appears between math delimiters, while the second does not.
+
+=== Inner text
+
+As noted in the introduction, mathematical text is enclosed in the
+standard delimiters and is written in the normal way.  Environments
+supported in display math mode are
+
+* matrix
+* equation, including the label macro
+
+
+=== Outer text
+
+To write a theorem, do this:
+
+----
+.Theorem {counter:theorem}
+--
+For all $a$, $b$, $c$, the relation $a(b+c) = ab + ac$ holds.
+--
+----
+
+This will render in Asciidoc as
+
+.Theorem {counter:theorem}
+--
+_For all $a$, $b$, $c$, the relation $a(b+c) = ab + ac$ holds._
+--