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.
ERB provides an easy to use but powerful templating system for Ruby. Using ERB,
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 erb.
- -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
evaluated.
- 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 leading 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>
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>
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 being fixed.
And you can report other bugs and feature requests via
the
Ruby Issue Tracking System (
http://bugs.ruby-lang.org). Do not
report security vulnerabilities via the system because it publishes the
vulnerabilities immediately.
AUTHORS¶
Written by Masatoshi SEKI.