Offset 1, 160 lines modifiedOffset 1, 184 lines modified
 1 .TH·ERB·\&1·"Ruby·Programmer's·Reference·Guide"·"December·16,·2018"·"UNIX"
1 .\"Ruby·is·copyrighted·by·Yukihiro·Matsumoto·<matz@netlab.jp>. 
2 .Dd·December·16,·2018 
3 .Dt·ERB·\&1·"Ruby·Programmer's·Reference·Guide" 
4 .Os·UNIX 
5 .Sh·NAME2 .SH·NAME
6 .Nm·erb3 \fBerb\fP
7 .Nd·Ruby·Templating4 \-·Ruby·Templating
8 .Sh·SYNOPSIS5 .SH·SYNOPSIS
9 .Nm 
10 .Op·Fl·-version 
11 .Op·Fl·UPdnvx 
12 .Op·Fl·E·Ar·ext·Ns·Op·Ns·:·Ns·int 
13 .Op·Fl·S·Ar·level 
14 .Op·Fl·T·Ar·mode 
15 .Op·Fl·r·Ar·library 
16 .Op·Fl·- 
17 .Op·file·... 
18 .Pp6 .br
 7 \fBerb\fP
 8 [\fB\--version\fP]
 9 [\fB\-UPdnvx\fP]
 10 [\fB\-E\fP·\fIext\fP[:int]]
 11 [\fB\-S\fP·\fIlevel\fP]
 12 [\fB\-T\fP·\fImode\fP]
 13 [\fB\-r\fP·\fIlibrary\fP]
 14 [\fB\--\fP]
 15 [file·...]
  
19 .Sh·DESCRIPTION16 .SH·DESCRIPTION
20 .Nm17 \fBerb\fP
21 is·a·command·line·front-end·for18 is·a·command·line·front-end·for
22 .Li·"ERB"19 "ERB"
23 library,·which·is·an·implementation·of·eRuby.20 library,·which·is·an·implementation·of·eRuby.
24 .Pp 
25 ERB·provides·an·easy·to·use·but·powerful·templating·system·for·Ruby.21 ERB·provides·an·easy·to·use·but·powerful·templating·system·for·Ruby.
26 Using·ERB,·actual·Ruby·code·can·be·added·to·any·plain·text·document·for·the22 Using·ERB,·actual·Ruby·code·can·be·added·to·any·plain·text·document·for·the
27 purposes·of·generating·document·information·details·and/or·flow·control.23 purposes·of·generating·document·information·details·and/or·flow·control.
28 .Pp 
29 .Nm 
 24 \fBerb\fP
30 is·a·part·of25 is·a·part·of
31 .Nm·Ruby·. 
32 .Pp26 \fBRuby\fP.
  
33 .Sh·OPTIONS27 .SH·OPTIONS
34 .Bl·-tag·-width·"1234567890123"·-compact 
35 .Pp 
36 .It·Fl·-version 
 28 .TP
 29 \fB\--version\fP
37 Prints·the·version·of30 Prints·the·version·of
38 .Nm·. 
39 .Pp 
40 .It·Fl·E·Ar·external·Ns·Op·:·Ns·Ar·internal 
41 .It·Fl·-encoding·Ar·external·Ns·Op·:·Ns·Ar·internal31 \fB.\fP
  
 32 .TP
 33 \fB\-E\fP·\fIexternal\fP[:\fIinternal\fP]
 34 .TP
 35 \fB\--encoding\fP·\fIexternal\fP[:\fIinternal\fP]
42 Specifies·the·default·value(s)·for·external·encodings·and·internal·encoding.·Values·should·be·separated·with·colon·(:).36 Specifies·the·default·value(s)·for·external·encodings·and·internal·encoding.·Values·should·be·separated·with·colon·(:).
43 .Pp 
44 You·can·omit·the·one·for·internal·encodings,·then·the·value37 You·can·omit·the·one·for·internal·encodings,·then·the·value
45 .Pf·(·Li·"Encoding.default_internal"·)·will·be·nil.38 ("Encoding.default_internal")·will·be·nil.
46 .Pp 
47 .It·Fl·P 
 39 .TP
 40 \fB\-P\fP
48 Disables·ruby·code·evaluation·for·lines·beginning·with41 Disables·ruby·code·evaluation·for·lines·beginning·with
49 .Li·"%"·. 
50 .Pp 
51 .It·Fl·S·Ar·level42 "%".
  
 43 .TP
 44 \fB\-S\fP·\fIlevel\fP
52 Specifies·the·safe·level·in·which·eRuby·script·will·run.45 Specifies·the·safe·level·in·which·eRuby·script·will·run.
53 .Pp 
54 .It·Fl·T·Ar·mode 
 46 .TP
 47 \fB\-T\fP·\fImode\fP
55 Specifies·trim·mode·(default·0).48 Specifies·trim·mode·(default·0).
56 .Ar·mode49 \fImode\fP
57 can·be·one·of50 can·be·one·of
58 .Bl·-hang·-offset·indent 
59 .It·Sy·051 .TP
 52 .B·0
60 EOL·remains·after·the·embedded·ruby·script·is·evaluated.53 EOL·remains·after·the·embedded·ruby·script·is·evaluated.
61 .Pp 
62 .It·Sy·1 
 54 .TP
 55 .B·1
63 EOL·is·removed·if·the·line·ends·with56 EOL·is·removed·if·the·line·ends·with
64 .Li·"%>"·. 
65 .Pp 
66 .It·Sy·257 "%>".
  
 58 .TP
 59 .B·2
67 EOL·is·removed·if·the·line·starts·with60 EOL·is·removed·if·the·line·starts·with
68 .Li·"<%"61 "<%"
69 and·ends·with62 and·ends·with
70 .Li·"%>"·. 
71 .Pp 
72 .It·Sy·-63 "%>".
  
 64 .TP
 65 .B·-
73 EOL·is·removed·if·the·line·ends·with66 EOL·is·removed·if·the·line·ends·with
74 .Li·"-%>"·.67 "-%>".
75 And·leading·whitespaces·are·removed·if·the·erb·directive·starts·with68 And·leading·whitespaces·are·removed·if·the·erb·directive·starts·with
76 .Li·"<%-"·. 
77 .Pp 
78 .El 
79 .It·Fl·r69 "<%-".
  
 70 .TP
 71 \fB\-r\fP
80 Load·a·library72 Load·a·library
81 .Pp 
82 .It·Fl·U 
 73 .TP
 74 \fB\-U\fP
83 can·be·one·of75 can·be·one·of
84 Sets·the·default·value·for·internal·encodings76 Sets·the·default·value·for·internal·encodings
85 .Pf·(·Li·"Encoding.default_internal"·)·to·UTF-8.77 ("Encoding.default_internal")·to·UTF-8.
86 .Pp 
87 .It·Fl·d 
88 .It·Fl·-debug 
 78 .TP
 79 \fB\-d\fP
 80 .TP
 81 \fB\--debug\fP
89 Turns·on·debug·mode.82 Turns·on·debug·mode.
90 .Li·"$DEBUG"83 "$DEBUG"
91 will·be·set·to·true.84 will·be·set·to·true.
92 .Pp 
93 .It·Fl·h 
94 .It·Fl·-help 
 85 .TP
 86 \fB\-h\fP
 87 .TP
 88 \fB\--help\fP
95 Prints·a·summary·of·the·options.89 Prints·a·summary·of·the·options.
96 .Pp 
97 .It·Fl·n 
 90 .TP
 91 \fB\-n\fP
98 Used·with92 Used·with
99 .Fl·x·.93 \fB\-x\fP.
100 Prepends·the·line·number·to·each·line·in·the·output.94 Prepends·the·line·number·to·each·line·in·the·output.
101 .Pp 
102 .It·Fl·v 
 95 .TP
 96 \fB\-v\fP
103 Enables·verbose·mode.97 Enables·verbose·mode.
104 .Li·"$VERBOSE"98 "$VERBOSE"
105 will·be·set·to·true.99 will·be·set·to·true.
106 .Pp 
107 .It·Fl·x 
 100 .TP
 101 \fB\-x\fP
108 Converts·the·eRuby·script·into·Ruby·script·and·prints·it·without·line·numbers.102 Converts·the·eRuby·script·into·Ruby·script·and·prints·it·without·line·numbers.
  
  
109 .Pp 
110 .El 
111 .Pp 
112 .Sh·EXAMPLES103 .SH·EXAMPLES
113 Here·is·an·eRuby·script104 Here·is·an·eRuby·script
114 .Bd·-literal·-offset·indent 
115 <?xml·version="1.0"·?>105 <?xml·version="1.0"·?>
 106 .br
116 <%·require·'prime'·-%>107 <%·require·'prime'·-%>
 108 .br
117 <erb-example>109 <erb-example>
 110 .br
118 ··<calc><%=·1+1·%></calc>111 ··<calc><%=·1+1·%></calc>
 112 .br
119 ··<var><%=·__FILE__·%></var>113 ··<var><%=·__FILE__·%></var>
 114 .br
120 ··<library><%=·Prime.each(10).to_a.join(",·")·%></library>115 ··<library><%=·Prime.each(10).to_a.join(",·")·%></library>
 116 .br
121 </erb-example>117 </erb-example>
122 .Ed 
123 .Pp118 .br
  
124 Command119 Command
 120 .nf
125 .Dl·"%·erb·-T·-·example.erb"121 \&··"%·erb·-T·-·example.erb"
 122 .fi
126 prints123 prints
127 .Bd·-literal·-offset·indent 
128 <?xml·version="1.0"·?>124 <?xml·version="1.0"·?>
 125 .br
129 <erb-example>126 <erb-example>
 127 .br
130 ··<calc>2</calc>128 ··<calc>2</calc>
 129 .br
131 ··<var>example.erb</var>130 ··<var>example.erb</var>
 131 .br
132 ··<library>2,·3,·5,·7</library>132 ··<library>2,·3,·5,·7</library>
 133 .br
133 </erb-example>134 </erb-example>
134 .Ed 
135 .Pp135 .br
  
136 .Sh·SEE·ALSO136 .SH·SEE·ALSO
137 .Xr·ruby·1·. 
138 .Pp137 \fBruby\fP(1).
  
139 And·see138 And·see
140 .Xr·ri·1139 \fBri\fP(1)
141 documentation·for140 documentation·for
142 .Li·"ERB"141 "ERB"
143 class.142 class.
144 .Pp 
145 .Sh·REPORTING·BUGS143 .SH·REPORTING·BUGS
 144 .IP·\(bu
146 .Bl·-bullet 
147 .It 
148 Security·vulnerabilities·should·be·reported·via·an·email·to145 Security·vulnerabilities·should·be·reported·via·an·email·to
149 .Mt·security@ruby-lang.org·.146 Mt·security@ruby-lang.org.
150 Reported·problems·will·be·published·after·being·fixed.147 Reported·problems·will·be·published·after·being·fixed.
151 .Pp 
152 .It 
 148 .IP·\(bu
153 Other·bugs·and·feature·requests·can·be·reported·via·the149 Other·bugs·and·feature·requests·can·be·reported·via·the
154 Ruby·Issue·Tracking·System150 Ruby·Issue·Tracking·System
155 .Pq·Lk·https://bugs.ruby-lang.org/·.151 (\fBhttps://bugs.ruby-lang.org/\fP).
156 Do·not·report·security·vulnerabilities152 Do·not·report·security·vulnerabilities
157 via·this·system·because·it·publishes·the·vulnerabilities·immediately.153 via·this·system·because·it·publishes·the·vulnerabilities·immediately.
158 .El 
159 .Sh·AUTHORS154 .SH·AUTHORS
160 Written·by·Masatoshi·SEKI.155 Written·by·Masatoshi·SEKI.