Erubis Users' Guide

release: 2.6.2

Preface

Erubis is an implementation of eRuby. It has the following features.

• Very fast, almost three times faster than ERB and about ten percent faster than eruby (implemented in C)
• File caching of converted Ruby script support
• Auto escaping support
• Auto trimming spaces around '<% %>'
• Embedded pattern changeable (default '<% %>')
• Enable to handle Processing Instructions (PI) as embedded pattern (ex. '<?rb ... ?>')
• Multi-language support (Ruby/PHP/C/Java/Scheme/Perl/Javascript)
• Context object available and easy to combine eRuby template with YAML datafile
• Print statement available
• Easy to expand and customize in subclass
• Ruby on Rails support
• mod_ruby support|#topcs-modruby

Erubis is implemented in pure Ruby. It requires Ruby 1.8 or higher. Erubis now supports Ruby 1.9.

Table of Contents

• Preface
  • Table of Contents
• Chapter 1   Installation
• Chapter 2   Tutorial
  • 2-1   Basic Example
  • 2-2   Trimming Spaces
  • 2-3   Escape
  • 2-4   Embedded Pattern
  • 2-5   Context Object
  • 2-6   Context Data File
  • 2-7   Context Data String
  • 2-8   Preamble and Postamble
  • 2-9   Processing Instruction (PI) Converter
  • 2-10   Retrieve Ruby Code
• Chapter 3   Enhancer
  • 3-1   EscapeEnhancer
  • 3-2   StdoutEnhancer
  • 3-3   PrintOutEnhancer
  • 3-4   PrintEnabledEnhancer
  • 3-5   ArrayEnhancer
  • 3-6   ArrayBufferEnhancer
  • 3-7   StringBufferEnhancer
  • 3-8   ErboutEnhancer
  • 3-9   NoTextEnhancer
  • 3-10   NoCodeEnhancer
  • 3-11   SimplifyEnhancer
  • 3-12   BiPatternEnhancer
  • 3-13   PercentLineEnhancer
  • 3-14   HeaderFooterEnhancer
  • 3-15   InterpolationEnhancer
  • 3-16   DeleteIndentEnhancer
• Chapter 4   Multi-Language Support
  • 4-1   PHP
  • 4-2   C
  • 4-3   Java
  • 4-4   Scheme
  • 4-5   Perl
  • 4-6   JavaScript
• Chapter 5   Ruby on Rails Support
  • 5-1   Settings
  • 5-2   Preprosessing
  • 5-3   Form Helpers for Preprocessing
  • 5-4   Others
• Chapter 6   Other Topics
  • 6-1   '<%= =%>' and '<%= -%>'
  • 6-2   '<%% %>' and '<%%= %>'
  • 6-3   evaluate(context) v.s. result(binding)
  • 6-4   Class Erubis::FastEruby
  • 6-5   Syntax Checking
  • 6-6   File Caching
  • 6-7   Erubis::TinyEruby class
  • 6-8   NoTextEnhancer and NoCodeEnhancer in PHP
  • 6-9   Helper Class for mod_ruby
  • 6-10   Define method
  • 6-11   Benchmark
• Chapter 7   Command Reference
  • 7-1   Usage
  • 7-2   Options
  • 7-3   Properties