From a8eb6018318f65e34486da8d1860b3f0d774383d Mon Sep 17 00:00:00 2001
From: Xavier Noria <fxn@hashref.com>
Date: Wed, 10 Sep 2014 19:23:41 +0200
Subject: i18n guide: clarify interpolation rules in _html keys [ci skip]

---
 guides/source/i18n.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

(limited to 'guides/source/i18n.md')

diff --git a/guides/source/i18n.md b/guides/source/i18n.md
index 1023598aa4..0761d5b39c 100644
--- 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)
-- 
cgit v1.2.3