i18n guide: clarify interpolation rules in _html keys [ci skip]

2014-09-10 19:23:41 +02:00 · 2014-09-10 19:23:41 +02:00 · a8eb601831
parent 4159159bec
commit a8eb601831
1 changed files with 16 additions and 0 deletions
--- a/guides/source/i18n.md
+++ b/guides/source/i18n.md
@ -676,6 +676,22 @@ en:
 <div><%= t('title.html') %></div>
 ```

+Interpolation escapes as needed though. For example, given:
+
+```yaml
+en:
+  welcome_html: "<b>Welcome %{username}!</b>"
+```
+
+you can safely pass the username as set by the user:
+
+```erb
+<%# This is safe, it is going to be escaped if needed. %>
+<%= t('welcome_html', username: @current_user.username %>
+```
+
+Safe strings on the other hand are interpolated verbatim.
+
 NOTE: Automatic conversion to HTML safe translate text is only available from the `translate` view helper method.

 ![i18n demo html safe](images/i18n/demo_html_safe.png)