登录/ 注册
 找回密码
 立即注册
关闭

CSDN热搜

豆瓜网 精品问答 技术交流 资源下载
返回列表 发新帖
首页 › 业界区 › 业界 ›Django国际化

Django国际化

官厌 前天 15:54
Django 提供了强大的国际化 (i18n) 和本地化 (l10n) 支持，让开发者能够轻松创建多语言网站。
1、核心概念与配置

1.1 基本配置

在 settings.py中启用国际化支持：
  1. # settings.py
  3. # 启用国际化
  4. USE_I18N = True
  5. USE_L10N = True  # 本地化格式（数字、日期等）
  6. USE_TZ = True    # 时区支持
  8. # 支持的语言
  9. LANGUAGES = [
  10.     ('en', 'English'),
  11.     ('zh-hans', '简体中文'),
  12. ]
  14. # 默认语言
  15. LANGUAGE_CODE = 'en'
  17. # 翻译文件位置
  18. LOCALE_PATHS = [
  19.     os.path.join(BASE_DIR, 'locale'),
  20. ]
  22. # 中间件配置（确保顺序正确）
  23. MIDDLEWARE = [
  24.     # ...
  25.     'django.middleware.locale.LocaleMiddleware',  # 在SessionMiddleware之后，CommonMiddleware之前
  26.     # ...
  27. ]
复制代码
1.2 项目结构建议
  1. my_project/
  2. ├── locale/           # 翻译文件目录
  3. │   ├── en/
  4. │   │   └── LC_MESSAGES/
  5. │   │       ├── django.po
  6. │   │       └── django.mo
  7. │   ├── zh_Hans/
  8. │   └── ja/
  9. ├── templates/
  10. │   ├── base.html
  11. │   └── includes/
  12. │       └── language_switcher.html
  13. ├── my_app/
  14. │   ├── locale/      # 应用特定翻译（可选）
  15. │   └── views.py
  16. └── manage.py
复制代码
2、模板中的国际化
  1. {% load i18n %}
  3. <!DOCTYPE html>
  4. <html lang="{{ request.LANGUAGE_CODE }}">
  5. <head>
  6.     <title>{% trans "Welcome to our site" %}</title>
  7. </head>
  8. <body>
  9.     <h1>{% trans "Hello, World!" %}</h1>
  10.    
  11.     {# 带变量的翻译 #}
  12.     <p>{% blocktrans with name=user.name %}Hello, {{ name }}!{% endblocktrans %}</p>
  13.    
  14.     {# 复数形式 #}
  15.     <p>
  16.         {% blocktrans count counter=item_count %}
  17.             You have {{ counter }} item.
  18.         {% plural %}
  19.             You have {{ counter }} items.
  20.         {% endblocktrans %}
  21.     </p>
  22. </body>
  23. </html>
复制代码
3、Python 代码中的国际化

3.1 视图和模型中的翻译
  1. # views.py
  2. from django.utils.translation import gettext as _
  3. from django.utils.translation import gettext_lazy, ngettext
  4. from django.http import JsonResponse
  5. from django.shortcuts import render
  7. def welcome_view(request):
  8.     # 简单翻译
  9.     message = _("Welcome to our application")
  10.    
  11.     # 带变量的翻译
  12.     username = request.user.username
  13.     greeting = _("Hello, %(username)s") % {'username': username}
  14.    
  15.     # 复数形式
  16.     item_count = 5
  17.     items_message = ngettext(
  18.         "You have %(count)d item",
  19.         "You have %(count)d items",
  20.         item_count
  21.     ) % {'count': item_count}
  22.    
  23.     return render(request, 'welcome.html', {
  24.         'message': message,
  25.         'greeting': greeting,
  26.         'items_message': items_message
  27.     })
  29. # API响应国际化
  30. def api_view(request):
  31.     return JsonResponse({
  32.         'message': _("Operation completed successfully"),
  33.         'error': _("Invalid input provided")
  34.     })
  36. # models.py
  37. from django.db import models
  38. from django.utils.translation import gettext_lazy as _
  40. class Product(models.Model):
  41.     name = models.CharField(_("Product name"), max_length=100)
  42.     description = models.TextField(_("Product description"))
  43.    
  44.     class Meta:
  45.         verbose_name = _("Product")
  46.         verbose_name_plural = _("Products")
  47.    
  48.     def __str__(self):
  49.         return _("Product: %(name)s") % {'name': self.name}
复制代码
3.2 表单和验证错误
  1. # forms.py
  2. from django import forms
  3. from django.utils.translation import gettext_lazy as _
  4. from django.core.validators import ValidationError
  6. class ContactForm(forms.Form):
  7.     name = forms.CharField(label=_("Your name"))
  8.     email = forms.EmailField(label=_("Email address"))
  9.     message = forms.CharField(
  10.         label=_("Message"),
  11.         widget=forms.Textarea,
  12.         error_messages={
  13.             'required': _("Please enter your message")
  14.         }
  15.     )
  16.    
  17.     def clean_email(self):
  18.         email = self.cleaned_data.get('email')
  19.         if not email.endswith('.com'):
  20.             raise ValidationError(_("Email must be from a .com domain"))
  21.         return email
  22.    
  23.     # 表单级别的错误消息
  24.     def clean(self):
  25.         cleaned_data = super().clean()
  26.         # 自定义验证逻辑
  27.         if cleaned_data.get('name') == cleaned_data.get('email'):
  28.             raise ValidationError(_("Name and email cannot be the same"))
复制代码
4、翻译文件

4.1 .po 文件
  1. # locale/zh_Hans/LC_MESSAGES/django.po
  3. # 清晰的注释说明上下文
  4. #. This message appears on the homepage banner
  5. msgid "Welcome to our site"
  6. msgstr "欢迎访问我们的网站"
  8. # 带变量的翻译
  9. msgid "Hello, %(username)s"
  10. msgstr "你好，%(username)s"
  12. # 复数形式
  13. msgid "You have %(count)d item"
  14. msgid_plural "You have %(count)d items"
  15. msgstr[0] "您有 %(count)d 个项目"
  16. msgstr[1] "您有 %(count)d 个项目"
  18. # 包含开发者注释
  19. # Translators: This message appears in the email subject
  20. msgid "Password reset request"
  21. msgstr "密码重置请求"
复制代码
4.2 提取和编译翻译
  1. # windows需要先安装gettext
  2. django-admin makemessages -l zh_Hans  # 简体中文
  3. django-admin makemessages -l en
  5. # 编译翻译文件
  6. django-admin compilemessages
  8. # 查看所有支持的语言
  9. python manage.py show_languag
复制代码
来源：豆瓜网用户自行投稿发布，如果侵权，请联系站长删除
Django国际化

使用道具 举报

相关推荐
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
发帖
官厌
前天 15:54

0

粉丝关注

22

主题发布

板块介绍填写区域，请于后台编辑
微信扫一扫