innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

Fixed #5591: corrected info about variables in `trans` tag. Thanks, idangazit. 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@8551 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Jacob Kaplan-Moss 2008-08-25 19:28:41 +00:00
parent 744d882110
commit f964a6e472
1 changed files with 11 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/topics/i18n.txt
View File

@ -219,21 +219,23 @@ Translations in :ref:`Django templates <topics-templates>` uses two template
tags and a slightly different syntax than in Python code. To give your template tags and a slightly different syntax than in Python code. To give your template
access to these tags, put ``{% load i18n %}`` toward the top of your template. access to these tags, put ``{% load i18n %}`` toward the top of your template.
The ``{% trans %}`` template tag translates a constant string or a variable The ``{% trans %}`` template tag translates either a constant string
content:: (enclosed in single or double quotes) or variable content::
<title>{% trans "This is the title." %}</title> <title>{% trans "This is the title." %}</title>
<title>{% trans myvar %}</title>
If you only want to mark a value for translation, but translate it later from a If the ``noop`` option is present, variable lookup still takes place but the
variable, use the ``noop`` option:: translation is skipped. This is useful when "stubbing out" content that will
require translation in the future::
<title>{% trans "value" noop %}</title> <title>{% trans "myvar" noop %}</title>
It's not possible to use template variables in ``{% trans %}`` -- only constant It's not possible to mix a template variable inside a string within
strings, in single or double quotes, are allowed. If your translations require ``{% trans %}``. If your translations require strings with variables (placeholders),
variables (placeholders), use ``{% blocktrans %}``. Example:: use ``{% blocktrans %}``. Example::
{% blocktrans %}This will have {{ value }} inside.{% endblocktrans %} {% blocktrans %}This string will have {{ value }} inside.{% endblocktrans %}
To translate a template expression -- say, using template filters -- you need To translate a template expression -- say, using template filters -- you need
to bind the expression to a local variable for use within the translation to bind the expression to a local variable for use within the translation