\n You can lead a new discussion or\n join\n
\n```\n\nYou probably don't want the HTML as part of the translation, because it\nmakes things brittle and potentially insecure. At the same time, you\nprobably want the translators to get the entire sentence with minimal\nnoise. So what do you do?\n\n#### Wrappers\n\nI18nliner lets you specify wrappers, so you can keep HTML out the\ntranslations, while still just having a single string needing translation:\n\n```handlebars\n\n {{t \"You can *lead* a new discussion or **join** an existing one.\"\n w0=\"$1\"\n w1=\"$1\"\n }}\n
\n```\n\nDelimiters are increasing numbers of asterisks.\n\n#### Blocks\n\nBut wait, there's more!\n\nPerhaps you want your templates to look like, well, templates. Try this:\n\n```handlebars\n\n {{#t}}\n Welcome to the internets, {{user.name}}\n {{/t}}\n
\n```\n\nOr even this:\n\n```handlebars\n\n {{#t}}\n Ohai {{user.name}},\n you can lead a new discussion or\n join an existing one\n {{/t}}\n
\n```\n\nIn case you're curious about the man behind the curtain, I18nliner adds a\npre-processor that turns the second example into something like this\nduring Handlebars parsing:\n\n```handlebars\n\n {{t \"some_unique_key\"\n \"*Ohai %{user_name}*, you can **lead** a new discussion or ***join*** an existing one.\"\n user_name=(user.name)\n w0=\"$1\"\n w1=(__i18nliner_concat \"$1\")\n w2=\"$1\"\n }}\n
\n```\n\nIn other words, it will infer wrappers from your (balanced) markup, and\nwill create placeholders for any other (inline) handlebars expressions.\nBlock helpers (e.g. `{{#if cond }}...`) are *not* supported within a\nblock translation. The only exception to this rule is nested translation\ncalls, e.g. this is totally fine:\n\n```handlebars\n{{#t}}\n Be sure to\n \n set up your account\n .\n{{/t}}\n```\n\n**TODO** grunt/broccoli instructions/links for enabling pre-processing\n\n#### HTML Safety\n\nI18nliner ensures translations, interpolated values, and wrappers all play\nnicely (and safely) when it comes to HTML escaping. If any translation,\ninterpolated value, or wrapper is HTML-safe, everything else will be HTML-\nescaped.\n\n## Related Projects\n\n* [i18nliner (ruby)](https://github.com/jenseng/i18nliner)\n* [i18nliner-js](https://github.com/jenseng/i18nliner-js)\n\n","readmeFilename":"README.md"}