erb_latex 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 85a04610d1b87c2b98b9b9c12236031c2a205018
+  data.tar.gz: f6f80ea5b96e39d6f8d1cc0abd0da6fe1c700410
+SHA512:
+  metadata.gz: b325e8f90702b6a105623667c00d707f9f905512c3687e637c28fd4d4074ba8691781b0d068e2405576b35d647b1dbae6920e6d17e6d993f40284c28f6485c7d
+  data.tar.gz: 873c768effa755f69585530350414b1529741ea6232a052c5269c08ee4cd045c360be2f5df3d4d2a1a8f5504e650f3272f00aac320deae88f1d131f61adebb7a

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in erb_latex.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,10 @@
+notification :growl
+
+guard :minitest, :all_on_start => true do
+    watch(%r{^test/test_helper\.rb}) { 'test' }
+
+    watch(%r{^test/.+_test\.rb})
+    watch(%r{^test/fixtures/(.+)s\.tex})   { |m| "test/erb_latex_test.rb" }
+
+    watch(%r{^lib/erb_latex/(.+)\.rb})     { |m| "test/erb_latex_test.rb" }
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Nathan Stitt
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,119 @@
+# ERB LaTeX
+
+Applies ERB template processing to a LaTeX file and compiles it to a PDF.
+
+Supports layouts, partials, and string escaping.
+
+Also supplies a Guard task to watch for modifications and auto-building files.
+
+## Use Case
+
+[Argosity](http://argosity.com/) uses this for several different projects
+
+ * [Nathan](http://nathan.stitt.org/) originally used a bare-bones of this to generate his resume.
+ * [Stockor](http://stockor.org/), our open-source ERP platform.  It's used for building all the form that output as PDF.
+ * Generating proposals for client projects.
+
+## Api Docs
+
+Are hosted at [nathan.stitt.org/code/erb-latex/](http://nathan.stitt.org/code/erb-latex/)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'erb_latex'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install erb_latex
+
+## Usage
+
+Given a LaTeX layout template: ``layout.tex``
+
+```latex
+\documentclass[12pt]{article}
+\usepackage{background}
+\usepackage{lettrine}
+\makeatletter
+\AddEverypageHook{
+  \SetBgContents{
+    \includegraphics[width=\paperwidth]{argosity-background-wave.png}
+  }
+  \SetBgPosition{current page.south}
+  \SetBgAnchor{above}
+  \SetBgAngle{0}
+  \SetBgScale{1}
+  \SetBgVshift{-2mm}
+  \SetBgOpacity{0.3}
+  \bg@material}
+\makeatother
+\begin{document}
+<%= yield %>
+\end{document}
+```
+
+and a simple LaTeX body: ``body.tex``
+
+```latex
+\lettrine[lines=2]{T}{hank} you for your your consideration.
+Please let us know if we can help you any further at all and don't forget to fill out the speakers notes.
+
+<%=q message %>
+
+Thank you,
+<%=q author %>
+```
+The following will convert it to a pdf
+
+```ruby
+require "erb_latex"
+
+tmpl = ErbLatex::Template.new( 'body.tex', {
+    :layout=>'layout.tex',
+    :data=>{
+        :author=>"Nathan",
+        :messge = "Please call our department at 555-5555"
+    }
+})
+tmpl.to_file('thank-you.pdf')
+```
+## Guard plugin
+
+ERB LaTeX also includes a plugin for [Guard](https://github.com/guard/guard) to automatically
+generate a PDF from a LaTeX file whenever the LaTeX file is modified.
+
+This is useful for shortening the build/review/modify cycle when developing a complex layout.
+
+A Guardfile such as this would compile all *.tex files in a directory
+
+```ruby
+require 'erb_latex/guard'
+
+guard :erb_latex do
+    watch(%r{.tex$})
+end
+```
+
+While the one below would compile the hypothetical body.tex file above
+
+```ruby
+require 'erb_latex/guard'
+
+guard :erb_latex, :layout=>'proposal.tex', :data=>{:author=>'Nathan Stitt', :message=>'Buy low, Sell High!'} do
+    watch 'body.tex'
+end
+```
+
+## Contributing
+
+1. Fork it ( http://github.com/nathanstitt/erb_latex/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,28 @@
+require "bundler/gem_tasks"
+
+require 'bundler/setup'
+require "bundler/gem_tasks"
+require 'rake/testtask'
+require 'yard'
+require 'guard'
+
+Rake::TestTask.new do |t|
+    t.libs << 'test'
+    t.pattern = "test/*_test.rb"
+end
+
+YARD::Rake::YardocTask.new do |t|
+    t.files   = ['lib/**/*.rb']
+    t.options = [
+      "--title=ERB LaTeX",
+      "--markup=markdown",
+      "--template-path=yard_ext/templates",
+      "--readme=README.md"
+    ]
+end
+
+desc "Deploy docs to web server"
+task :docs do
+    Rake::Task["yard"].invoke
+    system( "rsync", "doc/", "-avz", "--delete", "nathan.stitt.org:~/docs/erb-latex")
+end

data/erb_latex.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'erb_latex/version'
+
+Gem::Specification.new do |spec|
+    spec.name          = "erb_latex"
+    spec.version       = ErbLatex::VERSION
+    spec.authors       = ["Nathan Stitt"]
+    spec.email         = ["nathan@stitt.org"]
+    spec.summary       = %q{Applies ERB template processing to a Latex file and compiles it to a PDF}
+    spec.description   = %q{Applies ERB template processing to a Latex file and compiles it to a PDF.  Supports layouts, partials, and string escaping. Also supplies a Guard task to watch for modifications and auto-building files.}
+    spec.homepage      = "http://nathan.stitt.org/code/erb-latex/"
+    spec.license       = "MIT"
+
+    spec.files         = `git ls-files`.split($/)
+    spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+    spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+    spec.require_paths = ["lib"]
+
+    spec.add_development_dependency "bundler", "~> 1.5"
+    spec.add_development_dependency "rake",    "~> 10"
+    spec.add_development_dependency "growl",   "~> 1.0" # sorry Linux.  Anyone have suggestions on how to do this multi-platform?
+    spec.add_development_dependency "yard",    "~> 0.8"
+    spec.add_development_dependency "guard",   "~> 2.0"
+    spec.add_development_dependency "guard-minitest", "~> 2.2"  
+end

data/lib/erb_latex.rb

@@ -0,0 +1,17 @@
+require "erb_latex/version"
+require "erb_latex/errors"
+require "erb_latex/context"
+require "erb_latex/stringio"
+require "erb_latex/template"
+module ErbLatex
+
+
+
+    def self.xelatex_binary
+        defined?(@@xelatex_binary) ? @@xelatex_binary  : "xelatex"
+    end
+
+    def self.xelatex_binary=(bin)
+        @@xelatex_binary = bin
+    end
+end

data/lib/erb_latex/context.rb

@@ -0,0 +1,61 @@
+module ErbLatex
+
+    # Is the execution context for ERB evaluation
+    #
+    class Context
+
+        # List of characters that need to be escaped
+        # and their escaped values
+        ESCAPE = {
+            "#"=>"\\#",
+            "$"=>"\\$",
+            "%"=>"\\%",
+            "&"=>"\\&",
+            "~"=>"\\~{}",
+            "_"=>"\\_",
+            "^"=>"\\^{}",
+            "\\"=>"\\textbackslash{}",
+            "{"=>"\\{",
+            "}"=>"\\}"
+        }
+
+        # create new Context
+        # @param directory [String] directory to use as a base for finding partials
+        # @param data [Hash]
+        def initialize( directory, data )
+            @directory = directory
+            @data      = data
+            data.each{ |k,v| instance_variable_set( '@'+k.to_s, v ) }
+        end
+
+        # include another latex file into the current template
+        def partial( template, data={} )
+            view_file = @directory.join( template )
+            if view_file.exist?
+                context = Context.new( @directory, data )
+                ERB.new( view_file.read, 0, '-' ).result(  context.getBinding )
+            else
+                "missing partial: #{template}"
+            end
+        end
+
+        # convert newline characters into latex '\\newline'
+        def break_lines( txt )
+            q(txt.to_s).gsub("\n",'\\newline ')
+        end
+
+        # return a reference to the instance's scope or 'binding'
+        def getBinding
+            return binding()
+        end
+
+        # escape using latex escaping rules
+        # @param text string to escape
+        # @return [String] text after {ESCAPE} characters are replaced
+        def q(text)
+            text.to_s.gsub(  /([\^\%~\\\\#\$%&_\{\}])/ ) { |s| ESCAPE[s] }
+        end
+
+    end
+
+end

data/lib/erb_latex/errors.rb

@@ -0,0 +1,17 @@
+module ErbLatex
+
+    # Encapsolates an error that occurs while processing a latex template
+    class LatexError < RuntimeError
+
+        # @attribute [r] log
+        #   @return the log from the xelatex run
+        attr_reader :log
+
+        def initialize( msg, log )
+            super(msg)
+            @log = log
+        end
+
+    end
+
+end

data/lib/erb_latex/guard.rb

@@ -0,0 +1,58 @@
+require 'guard'
+require 'guard/plugin'
+require 'erb_latex'
+require 'erb_latex/guard_runner'
+
+module Guard
+
+
+    # The ErbLatex guard that gets notifications about the following
+    # Guard events: `start`, `run_all` and `run_on_modifications`.
+    class ErbLatex < Plugin
+
+        DEFAULT_OPTIONS = {
+            :layout       => false,
+            :data         => {},
+            :all_on_start => true,
+            :hide_success => false
+        }
+
+        # Initialize Guard::ErbLates
+        #
+        # @param [Hash] options the options for the Guard
+        # @option options [String] :layout, the layout to apply to latex files
+        # @option options [String] :data, for use during the ERB processing
+        # @option options [Boolean] :all_on_start process all latex files on start
+        # @option options [Boolean] :hide_success hide success message notification, unless the previous run failed
+        def initialize( options = {} )
+            super( DEFAULT_OPTIONS.merge(options) )
+        end
+
+        # Gets called once when Guard starts.
+        #
+        # @raise [:task_has_failed] when stop has failed
+        #
+        def start
+            run_all if options[:all_on_start]
+        end
+
+        # Gets called when all files should be regenerated.
+        #
+        # @raise [:task_has_failed] when stop has failed
+        #
+        def run_all
+            run_on_modifications( Watcher.match_files(self, Dir.glob('**{,/*/**}/*.{tex,erb.tex,tex.erb}')) )
+        end
+
+        # Gets called when watched paths and files have changes.
+        #
+        # @param [Array<String>] paths the changed paths and files
+        # @raise [:task_has_failed] when stop has failed
+        #
+        def run_on_modifications(paths)
+            throw :task_has_failed unless ::ErbLatex::GuardRunner.run( paths, watchers, options )
+        end
+
+    end
+
+end

data/lib/erb_latex/guard_runner.rb

@@ -0,0 +1,83 @@
+require 'erb_latex'
+
+module ErbLatex
+    module GuardRunner
+        class << self
+
+            attr_accessor :last_run_failed
+
+            # The ErbLatex runner handles the ErbLatex compilation,
+            # creates the output pdf file, writes the result
+            # to the console and triggers optional system notifications.
+            #
+            # @param [Array<String>] files the spec files or directories
+            # @param [Array<Guard::Watcher>] watchers the Guard watchers in the block
+            # @param [Hash] options the options for the execution
+            # @option options [String] :layout, the layout to apply to latex files
+            # @option options [String] :data, for use during the ERB processing
+            # @return [Array<Array<String>, Boolean>] the result for the compilation run
+            #
+            def run(files, watchers, options = { })
+                ::Guard::UI.info('Compiling ' + files.join(', '), :reset=>true )
+                changed_files, errors = compile_files(files, watchers, options)
+                notify_result(changed_files, errors, options)
+                return errors.empty?
+            end
+
+
+            private
+
+            # Compiles all ErbLatex files and writes the PDF files.
+            #
+            # @param [Array<String>] files the files to compile
+            # @param [Array<Guard::Watcher>] watchers the Guard watchers in the block
+            # @param [Hash] options the options for the execution
+            # @return [Array<Array<String>, Array<String>] the result for the compilation run
+            #
+            def compile_files(files, watchers, options)
+                errors        = []
+                changed_files = []
+
+                files.each do |file|
+                    begin
+                        pdf = ErbLatex::Template.new( file, options ).to_file
+                        changed_files << pdf
+                    rescue LatexError => e
+                        error_message = file + ': ' + e.message.to_s
+                        errors << error_message
+                        ::Guard::UI.error(color(error_message, ';31'), options)
+                    end
+                end
+                [changed_files.flatten.compact, errors]
+            end
+
+            # Writes console and system notifications about the result of the compilation.
+            #
+            # @param [Array<String>] changed_files the changed JavaScript files
+            # @param [Array<String>] errors the error messages
+            # @param [Hash] options the options for the execution
+            # @option options [Boolean] :hide_success hide success message notification
+            # @option options [Boolean] :noop do not generate an output file
+            #
+            def notify_result(changed_files, errors, options = { })
+                if !errors.empty?
+                    self.last_run_failed = true
+                    ::Guard::Notifier.notify(errors.join("\n"), :title => 'ErbLatex results', :image => :failed, :priority => 2)
+                elsif !options[:hide_success] || last_run_failed
+                    self.last_run_failed = false
+                    message = "Successfully #{ options[:noop] ? 'verified' : 'generated' } #{ changed_files.join(', ') }"
+                    ::Guard::UI.info(color( "#{Time.now.strftime('%r')} #{message}", ';32'), options)
+                    ::Guard::Notifier.notify(message, :title => 'ErbLatex results')
+                end
+            end
+
+            # Print a info message to the console.
+            # @param [String] text the text to colorize
+            # @param [String] color_code the color code
+            def color(text, color_code)
+                ::Guard::UI.send(:color_enabled?) ? "\e[0#{ color_code }m#{ text }\e[0m" : text
+            end
+
+        end
+    end
+end

data/lib/erb_latex/stringio.rb

@@ -0,0 +1,34 @@
+module ErbLatex
+
+    # An ErbLatex::StringIO extends Ruby's StringIO
+    # with a path and file name
+    # This allows it to be used in situations where a
+    # File is expected
+    class StringIO < ::StringIO
+
+        # @attribute [rw] filepath
+        #   @return [String] complete *virtual* path for the data
+        attr_accessor :filepath
+
+        def initialize( name='' )
+            @filepath = name
+            super('')
+            self.set_encoding( Encoding.find("UTF-8") )
+        end
+
+        # define original_filename for clients that
+        # depend on it, i.e. carrierwave
+        def original_filename
+            File.basename(filepath)
+        end
+
+        # reset filepath
+        # @param name [String] new value for filepath
+        # @return self
+        def rename( name )
+            @filepath = name
+            self
+        end
+    end
+
+end

data/lib/erb_latex/template.rb

@@ -0,0 +1,150 @@
+require "tmpdir"
+require "open3"
+require "erb"
+require 'pathname'
+require 'fileutils'
+
+module ErbLatex
+
+    # A template is an latex file that contains embedded ERB code
+    # It can optionally have a layout be rendered to either a file
+    # or StringIO instance
+    # @example for a hypothetical Rails controller
+    #     tmpl = ErbLatex::Template.new( 'article.tex',
+    #        :layout => 'layout.tex'
+    #        :data   => { :sentence=>"hello, this is doge" }
+    #     )
+    #     render :pdf => tmpl.to_stringio.read
+    #
+    class Template
+
+        # @attribute [r] log
+        #   @return [String] the log from the last xelatex run
+        # @attribute [r] pass_count
+        #   @return [Fixnum] how many passes it took to compile the tex into a PDF
+        attr_reader   :log,    :pass_count
+        # @attribute [rw] layout
+        #   @return [String] path to a file to use for layout
+        attr_accessor :layout
+
+        # create a new Template
+        # @param view_file [String] path to the latex template
+        # @option options [String] :layout path to a latex template that calls yield
+        # @option options [Hash] :data an instance variable will be created in the view for each key/value pair
+        def initialize( view_file, options={} )
+            @data   = options[:data] || {}
+            @layout = options[:layout]
+            @view   = Pathname.new( view_file )
+            @log  = ''
+        end
+
+        # Sets the data to be used for the template
+        # @param hash [Hash] data to set for the template
+        # An instance variable will be created for the template
+        # for each key in the hash with it's value set accordingly
+        def data=( hash )
+            @data  = hash
+        end
+
+        # @return [String] the suggested filename for this template.
+        # It removes the extension from the name and replaces it with '.pdf'
+        def suggested_filename
+            @view.basename.to_s.gsub(/\..*$/, '.pdf')
+        end
+
+        # Save the PDF to the file
+        # @param file [String,IO] if file is a String, the PDF is moved to the path indicated (most efficient).
+        #        Otherwise, file is considered an instance of IO, and write is called on it with the PDF contents
+        # @return [String,IO] the file
+        def to_file( file = suggested_filename )
+            execute do | contents |
+                if file.is_a?(String)
+                    FileUtils.mv contents, file
+                else
+                    file.write contents.read
+                    pdf.rewind
+                end
+            end
+            file
+        end
+
+        # @return [StringIO] containing the the PDF
+        def to_stringio
+            to_file( ::ErbLatex::StringIO.new(suggested_filename) ).rewind
+        end
+
+        # Compile the Latex template into a PDF file
+        # @yield [Pathname] complete path to the PDF file
+        # @raise [LatexError] if the xelatex process does not complete successfully
+        def execute
+            latex = compile_latex
+            Dir.mktmpdir do | dir |
+                @pass_count = 0
+                @log        = ''
+                success     = false
+                while log_suggests_rerunning? && @pass_count < 5
+                    @pass_count += 1
+                    success = execute_xelatex(latex,dir)
+                end
+                pdf_file = Pathname.new(dir).join( "output.pdf" )
+                if success && pdf_file.exist?
+                    yield pdf_file
+                else
+                    errors = @log.scan(/\*\!\s(.*?)\n\s*\n/m).map{|e| e.first.gsub(/\n/,'') }.join("; ")
+                    raise LatexError.new( errors.empty? ? "xelatex compile error" : errors, @log )
+                end
+            end
+        end
+
+        # @return [Pathname] layout file
+        def layout_file
+            Pathname.new( layout )
+        end
+
+        # Runs the ERB pre-process on the latex file
+        # @return [String] latex with ERB substitutions performed
+        # @raise [LatexError] if the xelatex process does not complete successfully
+        def compile_latex
+            begin
+                context = ErbLatex::Context.new( @view.dirname, @data )
+                content = ERB.new( @view.read, 0, '-' ).result( context.getBinding )
+                if layout
+                    ERB.new( layout_file.read, nil, '-' ).result( context.getBinding{
+                        content
+                    })
+                else
+                    content
+                end
+            rescue RuntimeError,LocalJumpError=>e
+                raise LatexError.new( "ERB compile raised #{e.class} on #{@view}", e.backtrace )
+            end
+        end
+
+        private
+
+        # @return [Boolean] True if the log is empty(not ran yet), or contains the string "Rerun"
+        def log_suggests_rerunning?
+            @log.empty? || !! ( @log =~ /Rerun/ )
+        end
+
+        # Execute xelatex on the file.
+        # @param latex [String] contents of the template after running ERB on it
+        # @param dir   [String] path to the temporary working directory
+        def execute_xelatex( latex, dir )
+            success = false
+            @log    = ''
+            Open3.popen2e( ErbLatex.xelatex_binary,
+              "--no-shell-escape", "-shell-restricted",
+              "-jobname=output",   "-output-directory=#{dir}",
+            ) do |stdin, output, wait_thr|
+                stdin.write latex
+                stdin.close
+                @log    = output.read.strip
+                success = ( 0 == wait_thr.value )
+            end
+            success
+        end
+
+    end
+
+end

data/lib/erb_latex/version.rb

@@ -0,0 +1,5 @@
+module ErbLatex
+
+    VERSION = "0.0.1"
+
+end

data/test/erb_latex_test.rb

@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*-
+require 'helper'
+
+class ErbLatexTest < MiniTest::Test
+
+
+    def test_document
+        tmpl = ErbLatex::Template.new( document(:valid) )
+        tmpl.to_file tmp_output_file
+        assert_match "This is a very simple file", text_output
+    end
+
+    def test_errors
+        tmpl = ErbLatex::Template.new( document(:with_error) )
+        assert_raises(ErbLatex::LatexError) do
+            tmpl.to_stringio
+        end
+    end
+
+    def test_layout
+        tmpl = ErbLatex::Template.new( document(:body),
+                                       :layout => document(:layout),
+                                       :data   => { :sentence=>"hello, this is doge" }
+                                     )
+        tmpl.to_file tmp_output_file
+        assert_match "hello, this is doge", text_output
+    end
+
+    def test_multiple_runs
+        tmpl = ErbLatex::Template.new( document(:multi_page) )
+        tmpl.to_file tmp_output_file
+        assert_equal 2, tmpl.pass_count
+        text = text_output
+        assert_match "Page 1 of 3", text
+        assert_match "Page 2 of 3", text
+        assert_match "Page 3 of 3", text
+    end
+
+    def test_partials
+        tmpl = ErbLatex::Template.new( document(:with_partial) )
+        tmpl.to_file tmp_output_file
+        assert_match "a test ’ of a partial", text_output
+    end
+
+end

data/test/fixtures/body.tex.erb

@@ -0,0 +1 @@
+<%= @sentence %>

data/test/fixtures/layout.tex.erb

@@ -0,0 +1,4 @@
+\documentclass[12pt]{article}
+\begin{document}
+<%= yield %>
+\end{document}

data/test/fixtures/multi_page.tex.erb

@@ -0,0 +1,16 @@
+\documentclass[oneside,12pt]{memoir}
+\usepackage{xltxtra}
+\usepackage{lastpage}
+\usepackage[T1]{fontenc}
+\makepagestyle{plain}
+\makeoddfoot{plain}{}{}{Page \thepage\ of \pageref{LastPage}}
+\makeevenfoot{plain}{}{}{Page \thepage\ of \pageref{LastPage}}
+\begin{document}
+\pagestyle{plain}
+Page 1
+\newpage
+Page 2
+\newpage
+Page 3
+\newpage
+\end{document}

data/test/fixtures/partial.tex.erb

@@ -0,0 +1 @@
+<%=q @sentence %>

data/test/fixtures/valid.tex.erb

@@ -0,0 +1,34 @@
+\documentclass[12pt]{article}
+\begin{document}
+
+  This is a very simple file, though it does include some mathematical
+  symbols, $\beta, x$ and $y$,  and some equations,
+ \begin{equation}
+ \frac{1}{2} + \frac{1}{5} =  \frac{7}{10}.
+  \end{equation}
+
+ The equations are automatically numbered:
+\begin{equation}
+ 1 + 1 = 2 \Rightarrow E = m c^2.
+\end{equation}
+
+  \LaTeX\ can handle complicated mathematical expressions.
+ \begin{equation}
+ \int_0^\infty \cos (k t) e^{-s t} d t = \frac{s}{s^2 + k^2}
+ \end{equation}
+ if $s > 0$.
+ \begin{equation}
+ e^z = \sum_{n=0}^\infty \frac{ z^n}{n!} .
+ \end{equation}
+
+ Leave a blank line in your file when you want a new paragraph.
+      \LaTeX\ will automatically
+ arrange your text
+              into tidy lines of
+ even length, even
+ if the
+ original text in the .tex file is a mess.
+
+\sffamily\textregistered\textcopyright <%= @person %>
+
+\end{document}

data/test/fixtures/with_error.tex.erb

@@ -0,0 +1 @@
+This document is in no way a valid LaTex Document

data/test/fixtures/with_partial.tex.erb

@@ -0,0 +1,4 @@
+\documentclass[12pt]{article}
+\begin{document}
+<%= partial 'partial.tex.erb', :sentence=>"a test ' of a partial" %>
+\end{document}

data/test/helper.rb

@@ -0,0 +1,32 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+#require 'test/unit'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'erb_latex'
+
+class MiniTest::Test
+
+    def document( name )
+        File.expand_path(File.join(File.dirname(__FILE__), "fixtures/#{name}.tex.erb"))
+    end
+
+    def tmp_output_file
+        File.expand_path( File.join( File.dirname(__FILE__), "tmp/output.pdf") )
+    end
+
+
+    def text_output
+        `pdftotext #{tmp_output_file} -`
+    end
+
+end

data/yard_ext/templates/default/method_details/html/github_link.erb

@@ -0,0 +1 @@
+ [<a href="https://github.com/nathanstitt/code/erb_latex/tree/master/<%= object.file %><% if object.line %>#L<%= object.line %><% end %>">github</a>]

data/yard_ext/templates/default/method_details/setup.rb

@@ -0,0 +1,3 @@
+def source
+    super + erb(:github_link)
+end

metadata

@@ -0,0 +1,166 @@
+--- !ruby/object:Gem::Specification
+name: erb_latex
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Nathan Stitt
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10'
+- !ruby/object:Gem::Dependency
+  name: growl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+description: Applies ERB template processing to a Latex file and compiles it to a
+  PDF.  Supports layouts, partials, and string escaping. Also supplies a Guard task
+  to watch for modifications and auto-building files.
+email:
+- nathan@stitt.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- erb_latex.gemspec
+- lib/erb_latex.rb
+- lib/erb_latex/context.rb
+- lib/erb_latex/errors.rb
+- lib/erb_latex/guard.rb
+- lib/erb_latex/guard_runner.rb
+- lib/erb_latex/stringio.rb
+- lib/erb_latex/template.rb
+- lib/erb_latex/version.rb
+- test/erb_latex_test.rb
+- test/fixtures/body.tex.erb
+- test/fixtures/layout.tex.erb
+- test/fixtures/multi_page.tex.erb
+- test/fixtures/partial.tex.erb
+- test/fixtures/valid.tex.erb
+- test/fixtures/with_error.tex.erb
+- test/fixtures/with_partial.tex.erb
+- test/helper.rb
+- yard_ext/templates/default/method_details/html/github_link.erb
+- yard_ext/templates/default/method_details/setup.rb
+homepage: http://nathan.stitt.org/code/erb-latex/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.1
+signing_key: 
+specification_version: 4
+summary: Applies ERB template processing to a Latex file and compiles it to a PDF
+test_files:
+- test/erb_latex_test.rb
+- test/fixtures/body.tex.erb
+- test/fixtures/layout.tex.erb
+- test/fixtures/multi_page.tex.erb
+- test/fixtures/partial.tex.erb
+- test/fixtures/valid.tex.erb
+- test/fixtures/with_error.tex.erb
+- test/fixtures/with_partial.tex.erb
+- test/helper.rb
+has_rdoc: