i18n documentation: Incorrect statement about template variables in {% trans %}

[elsdoerfer@…]

The documentation at:

​http://www.djangoproject.com/documentation/i18n/#in-template-code

states:

It’s not possible to use template variables in {% trans %} — only constant strings, in single or double quotes, are allowed.

However, it works for me (django.templatetags.i18n.TranslateNode.render() includes a call to resolve_variable).

[Nick Efford]

Any more info available on this? I am unable to reproduce this.

I tried passing a template variable as the string argument of {% trans %}, and I also tried embedding a template variable in the string passed to {% trans %}. In the latter case, the variable is simply ignored, and in the former case I see a
TemplateSyntaxError with the message only option for 'trans' is 'noop'.

In other words, the docs seem consistent with what I observe - unless I am being completely dense and not getting the point here (which to be honest occurs frequently :)

[miracle2k]

Using current SVN (but no actual translations loaded):

In [17]: Template('{% load i18n %}{% trans var %}').render({'var': "foobar"})
Out[17]: u'foobar'

[Idan Gazit]

Documents the operation of trans/blocktrans tags

[Idan Gazit]

The {% trans %} template tag translates either a constant string (enclosed in single or double quotes) or variable content. It's not possible to mix a template variable inside a string within {% trans %}. If your translations require strings with variables (placeholders),
use {% blocktrans %}.

>>> Template('{% load i18n %}{% trans "this is {{var}} for you" %}').render({'var': "foobar"})

u'this is {{var}} for you'

>>>  Template('{% load i18n %}{% blocktrans %}This will have {{ var }} inside.{% endblocktrans %}').render(Context({'var': "foobar"}))

u'This will have foobar inside.'

Patch for clearer documentation attached, including a clearer noop explanation.

[Malcolm Tredinnick]

Should wait until after docs-refactor lands to be committed (at which point the patch should be rewritte).

[Idan Gazit]

Same patch, applied to trunk post-docs-refactor

[Idan Gazit]

Updated documentation patch to work following docs-refactor in r8506

[Jacob]

(In [8551]) Fixed #5591: corrected info about variables in trans tag. Thanks, idangazit.

[Jacob]

Milestone 1.0 deleted