Backend - Django 多语言

目录

一、安装 GNU gettext

（一）说明

（二）下载并解压（自定义文件包名）

（三）安装并配置环境变量

        1. 安装

        2. 配置环境变量

（四）查看是否安装

二、settings.py配置

（一）设置多语言的middleware（启用多语言支持）

（二）设置i18n上下文渲染器

（三）开启国际化，创建翻译文件存储位置

        1. 开启国际化，设置可选语言列表

        2. 多语言文件存放位置

        3. 并在manage.py所在目录下创建locale文件夹（与manage.py同层级）

（四）生成.po文件（会存放在locale文件夹内）

（五）编辑.po文件好后，执行编译生成mo文件

       1. 例子

        2. 注意

（六）执行编译

（七）激活多语言

三、应用

（一）html 模板，使用多语言

1. 前提设置

2. 使用时

（二）views使用

1. views和html的例子

（1）views.py

（2）templates.html

（三）admin后台管理界面

1. models值显示

（1）导入多语言包

（2）设置model的栏位名

 （3）设置model的自身名

 2. settings值显示

四、切换多语言

（一）第一种：同个View视图处理

 1. urls.py

 2. views.py

 3. lang.html

（二）第二种：不同方法处理，再重定向到原View视图

1. urls.py

 2. views.py

 3. lang.html

---

一、安装 GNU gettext

（一）说明

        GNU gettext 是国际化(i18n)和本地化(i10n)工具

（二）下载并解压（自定义文件包名）

        下载地址：https://mlocati.github.io/articles/gettext-iconv-windows.html

（三）安装并配置环境变量

        1. 安装

        将解压后的文件包(自命名Django Language)放置在此电脑某盘。

        2. 配置环境变量

        此电脑 > 右键选择内容属性 > 进阶系统设置 > 进阶页签中点击环境变量 > path中新增D:\XXX\Django Language\bin > 一般设置环境变量后，得重启电脑。

（四）查看是否安装

        Windows运行终端cmd，输入如下指令

xgettext --version

        例子： 

二、settings.py配置

（一）设置多语言的middleware（启用多语言支持）

MIDDLEWARE = […'django.middleware.locale.LocaleMiddleware',  # 多语言(LocaleMiddleware这个中间件，应于SessionMiddleware之后，CommonMiddleware之前)'django.middleware.common.CommonMiddleware',  # 多语言（顺序尽量靠前）
]

（二）设置i18n上下文渲染器

TEMPLATES = [{'BACKEND': 'django.template.backends.django.DjangoTemplates','DIRS': [os.path.join(BASE_DIR, 'templates')],'APP_DIRS': True,'OPTIONS': {'context_processors': […'django.template.context_processors.i18n',  # i18n上下文渲染器],},}
]

（三）开启国际化，创建翻译文件存储位置

        1. 开启国际化，设置可选语言列表

TIME_ZONE = 'Asia/Shanghai'  # 亚洲上海
USE_I18N = True  # 开启国际化(Internationalization)
USE_L10N = True  # 开启本地化(localization)
USE_TZ = False  # 关闭时区支持（是否错过8小时）from django.utils.translation import ugettext_lazy as _
LANGUAGES = (('en', _('English')),('zh-hans', _('中文简体')),
)

        2. 多语言文件存放位置

LOCALE_PATHS = (os.path.join(BASE_DIR, 'locale'),),  # 多语言翻译文件存放位置

        3. 并在manage.py所在目录下创建locale文件夹（与manage.py同层级）

（四）生成.po文件（会存放在locale文件夹内）

python manage.py makemessages -l en
python manage.py makemessages -l zh_Hans

（五）编辑.po文件好后，执行编译生成mo文件

       1. 例子

        编辑zh_HAnt的po文件内容，将文本翻译为中文。

msgid "luobogan"
msgstr "萝卜干"

        2. 注意

        翻译的目标最好不要重复（代码赘余）。

        先在locale>tz>django.po中查找是否有设置想要翻译的目标，若无，才新增。

（六）执行编译

python manage.py compilemessages 
# 或者
django-admin compilemessages

（七）激活多语言

        无论是只有前端转换，还是说既有后端转换好传向前端，又有前端转换。

        都必须要在views中的get()和postt()里添加多语言激活。

active('zh-hans')

三、应用

包括：models、 views、templates多语言使用。

（一）html 模板，使用多语言

1. 前提设置

        在html模板文件头部添加 {% load i18n %}

2. 使用时

 {%  trans 'XXX' %}

注意：多个地方翻译成同名，则使用{% trans "luobo" as luobogan %}

（二）views使用

from django.utils.translation import activate
from django.utils.translation import gettext as _
activate('zh-hans')
user = _("luobo")

1. views和html的例子

（1）views.py

from django.utils.translation import activate
from django.utils.translation import gettext as _
class BookRead(View):def get(self, request):activate('zh-hans')return render(request, 'book/book_read.html', {'booktb': _('Book Table')})

（2）templates.html

<div><h1>{{ booktb }}</h1><div><th><h4>{% trans "tb_thead" %}</h4></th>

（三）admin后台管理界面

1. models值显示

（1）导入多语言包

from django.utils.translation import gettext_lazy as _

（2）设置model的栏位名

        在model类里的栏位中设置verbose_name，並用_( ) 包裹。

class Book(models.Model):bookname = models.CharField(verbose_name= _("BookName"), max_length=40)

 （3）设置model的自身名

        在model类里的class Meta中设置verbose_name_plural，並用_( ) 包裹。

class Book(models.Model):bookname = models.CharField(verbose_name="BookName", max_length=40)class Meta:verbose_name = _("Book")verbose_name_plural = verbose_name  # 对象是复数时，与单数的别名一致

 2. settings值显示

# from django.utils.translation import ugettext_lazy as _
from django.utils.translation import gettext as _
ADMIN_REORDER = ({'app': 'auth','label': _('Book Admin'),'models': ('auth.User','auth.Group','C_runMES.GroupPermissions','C_runMES.URL',),},
)

四、切换多语言

（一）第一种：同个View视图处理

 1. urls.py

urlpatterns = [# . . .path('url_set_lang/', views_base.SetLang.as_view(), name='url_set_lang'),  # Set Lang 初始化界面path('url_lang/<language>/', views_base.SetLang.as_view(), name='url_change_lang'),  # Change Lang 处理界面
]

 2. views.py

class SetLang(View):def get(self, request, *args, **kwargs):try:lang = kwargs['language'] if kwargs.get('language') else 'zh-hans'activate(lang)return render(request, 'lang.html', {'opts': ['zh-hans', 'en'], 'setlang': _('Set Django Language')})except Exception as e:print('error: ', str(e))

 3. lang.html

<select onchange="window.location=this.value"><option disabled selected>----请选择----</option><option value="/url_lang/zh-hans">zh-hans</option><option value="/url_lang/en">en</option>
</select>

（二）第二种：不同方法处理，再重定向到原View视图

1. urls.py

urlpatterns = [# . . .path('url_set_lang/', views_base.SetLang.as_view(), name='url_set_lang'),  # Set Lang 初始化界面path('url_lang/en/', views_base.lang_en, name='lang_en'),  # Change Lang 处理界面(en)path('url_lang/zh-hans/', views_base.lang_hans, name='lang_hans'),  # Change Lang 处理界面(zh-hans)
]

 2. views.py

class SetLang(View):def get(self, request, *args, **kwargs):try:lang = request.session['language'] if request.session.get('language') else 'zh-hans'activate(lang)return render(request, 'lang.html', {'opts': ['zh-hans', 'en'], 'setlang': _('Set Django Language')})except Exception as e:print('error: ', str(e))def lang_en(request):try:return _set_lang(request, 'en')except Exception as e:print('error: ', str(e))def lang_hans(request):try:return _set_lang(request, 'zh-hans')except Exception as e:print('error: ', str(e))def _set_lang(request, lang):request.session['language'] = langnext = request.META.get('HTTP_REFERER')next = next and unquote(next)  # HTTP_REFERER may be encoded.return HttpResponseRedirect(next)  # 重定向到原路由的get方法

 3. lang.html

<select onchange="window.location=this.value"><option disabled selected>----请选择----</option><option value="/url_lang/zh-hans">zh-hans</option><option value="/url_lang/en">en</option>
</select>