erubis

Langue: en

Version: 253713 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

erubis - eRuby style template engine for multiple languages

SYNOPSIS

erubis [..options..] [file ...]

DESCRIPTION

Embedded templating engine for multiple languages. Erubis will take a template file as input and output code to convey that data in the language specified. The following output languages are supported:

 * Ruby
 * PHP
 * C
 * Java
 * Scheme
 * Perl
 * JavaScript

OPTIONS

-h, --help
help
-v
version
-x
show converted code
-X
show converted code, only ruby code and no text part
-N
numbering: add line numbers (for '-x/-X')
-U
unique: compress empty lines to a line (for '-x/-X')
-C
compact: remove empty lines (for '-x/-X')
-b
body only: no preamble nor postamble (for '-x/-X')
-z
syntax checking
-e
escape (equal to '--E Escape')
-p pattern
embedded pattern (default '<% %>')
-l lang
convert but no execute (ruby/php/c/java/scheme/perl/js)
-E e1,e2,...
enhancer names (Escape, PercentLine, BiPattern, ...)
-I path
library include path
-K kanji
kanji code (euc/sjis/utf8) (default none)
-c context
context data string (yaml inline style or ruby code)
-f datafile
context data file ('*.yaml', '*.yml', or '*.rb')
-T
don't expand tab characters in YAML file
-S
convert mapping key from string to symbol in YAML file
-B
invoke 'result(binding)' instead of 'evaluate(context)'
--pi=name
parse '<?name ... ?>' instead of '<% ... %>'

supported properties:

* (common)
--escapefunc=nil
: escape function name
--pattern="<% %>"
: embed pattern
--trim=true
: trim spaces around <% ... %>
--preamble=nil
: preamble (no preamble when false)
--postamble=nil
: postamble (no postamble when false)
--escape=nil
: escape expression or not in default
* (basic) * (pi)
--pi="rb"
: PI (Processing Instrunctions) name
--embchar="@"
: char for embedded expression pattern('@{...}@')
* ruby * php * c
--indent=""
: indent spaces (ex. ' ')
--out="stdout"
: output file pointer name
* java
--indent=""
: indent spaces (ex. ' ')
--buf="_buf"
: output buffer name
--bufclass="StringBuffer" : output buffer class (ex. 'StringBuilder')
* scheme
--func="_add"
: function name (ex. 'display')
* perl
--func="print"
: function name
* javascript
--docwrite=true
: use 'document.write()' when true

EXAMPLES

Run 'erubis -l php example.ephp' to convert the embedded document to php code.

example.ephp:
 <?xml version="1.0"?>
 <html>
  <body>
   <p>Hello <%= $user %>!</p>
   <table>
    <tbody>
     <% $i = 0; %>
     <% foreach ($list as $item) { %>
     <%   $i++; %>
     <tr bgcolor="<%= $i % 2 == 0 ? '#FFCCCC' : '#CCCCFF' %>">
      <td><%= $i %></td>
      <td><%== $item %></td>
     </tr>
     <% } %>
    </tbody>
   </table>
  </body>
 </html>

SEE ALSO

http://rubyforge.org/projects/erubis/