erb
(1)
Name
erb - Ruby Templating
Synopsis
erb [--version] [-UPdnvx] [-E ext[]]:int [-S level] [-T
mode] [-r library] [--] [file ...]
Description
UNIX ERB(1)
NAME
erb - Ruby Templating
SYNOPSIS
erb [--version] [-UPdnvx] [-E ext[]]:int [-S level] [-T
mode] [-r library] [--] [file ...]
DESCRIPTION
erb is a command line front-end for "ERB" library, which is
an implementation of eRuby.
eRuby provides an easy to use but powerful templating system
for Ruby. Using eRuby, actual Ruby code can be added to any
plain text document for the purposes of generating document
information details and/or flow control.
erb is a part of Ruby.
OPTIONS
--version
Prints the version of
-E external[]:internal
--encoding external[]:internal
Specifies the default value(s) for external encodings
and internal encoding. Values should be separated with
colon (:).
You can omit the one for internal encodings, then the
value ("Encoding.default_internal") will be nil.
-P Evaluates lines starting with "%" as Ruby code and
removes the tailing EOLs.
-S level
Specifies the safe level in which eRuby script will
run.
-T mode
Specifies trim mode (default 0). mode can be one of
0 EOL remains after the embedded ruby script is evalu-
ated.
December 2Last0change: Ruby Programmers Reference Guide 1
UNIX ERB(1)
1 EOL is removed if the line ends with "%>".
2 EOL is removed if the line starts with "<%" and ends
with "%>".
- EOL is removed if the line ends with "-%>". And lead-
ing whitespaces are removed if the erb directive starts
with "<%-".
-U can be one of Sets the default value for internal
encodings ("Encoding.default_internal") to UTF-8.
-d
--debug
Turns on debug mode. "$DEBUG" will be set to true.
-h
--help
Prints a summary of the options.
-n Used with -x. Prepends the line number to each line in
the output.
-v Enables verbose mode. "$VERBOSE" will be set to true.
-x Converts the eRuby script into Ruby script and prints
it without line numbers.
EXAMPLES
Here is an eRuby script
<?xml version="1.0" ?>
<% require 'prime' -%>
<erb-example>
<calc><%= 1+1 %></calc>
<var><%= __FILE__ %></var>
<library><%= Prime.each(10).to_a.join(", ") %></library>
</erb-example>
December 2Last0change: Ruby Programmers Reference Guide 2
UNIX ERB(1)
Command
"% erb -T - example.erb"
prints
<?xml version="1.0" ?>
<erb-example>
<calc>2</calc>
<var>example.erb</var>
<library>2, 3, 5, 7</library>
</erb-example>
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | runtime/ruby-19 |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
SEE ALSO
ruby(1).
And see ri(1) documentation for "ERB" class.
REPORTING BUGS
Security vulnerabilities should be reported via an email to
<security@ruby-lang.org> Reported problems will be published
after fixed.
And you can report other bugs and feature requests via the
Ruby Issue Tracking System (http://redmine.ruby-lang.org).
Do not report security vulnerabilities via the system
because it publishes the vulnerabilities immediately.
AUTHORS
Written by Masatoshi SEKI.
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from http://ftp.ruby-
lang.org/pub/ruby/1.9/ruby-1.9.3-p484.tar.gz
Further information about this software can be found on the
December 2Last0change: Ruby Programmers Reference Guide 3
UNIX ERB(1)
open source community website at http://www.ruby-lang.org/.
December 2Last0change: Ruby Programmers Reference Guide 4