使用函數 ugettext() 來指定一個翻譯字串。 作為慣例,使用短別名 _ 來引入這個函數以節省鍵入時間.
在下面這個例子中,文本 "Welcome to my site" 被標記為待翻譯字串:
from django.utils.translation import ugettext as _def my_view(request): output = _("Welcome to my site.") return HttpResponse(output)
顯然,你也可以不使用別名來編碼。 下面這個例子和前面兩個例子相同:
from django.utils.translation import ugettextdef my_view(request): output = ugettext("Welcome to my site.") return HttpResponse(output)
翻譯字串對於計算出來的值同樣有效。 下面這個例子等同前面一種:
def my_view(request): words = ['Welcome', 'to', 'my', 'site.'] output = _(' '.join(words)) return HttpResponse(output)
翻譯對變數也同樣有效。 這裡是一個同樣的例子:
def my_view(request): sentence = 'Welcome to my site.' output = _(sentence) return HttpResponse(output)
(以上兩個例子中,對於使用變數或計算值,需要注意的一點是Django的待翻譯字串偵查工具, make-messages.py ,將不能找到這些字串。 稍後,在 makemessages 中會有更多討論。)你傳遞給 _() 或 gettext() 的字串可以接受預留位置,由Python標準命名字串插入句法指定的。 例如:
def my_view(request, m, d): output = _('Today is %(month)s %(day)s.') % {'month': m, 'day': d} return HttpResponse(output)
這項技術使得特定語言的譯文可以對這段文本進行重新排序。 比如,一段英語譯文可能是 "Today is November 26." ,而一段西班牙語譯文會是 "Hoy es 26 de Noviembre." 使用預留位置(月份和日期)交換它們的位置。
由於這個原因,無論何時當你有多於一個單一參數時,你應當使用命名字串插入(例如: %(day)s )來替代位置插入(例如: %s or %d )。 如果你使用位置插入的話,翻譯動作將不能重新排序預留位置文字。