django 国际化

参考文档：

• https://docs.djangoproject.com/zh-hans/2.2/topics/i18n/translation/
• https://blog.csdn.net/qq_36963372/article/details/88788463
• https://www.jianshu.com/p/b7fd0658989d

配置 settings

MIDDLEWARE = [
   'django.contrib.sessions.middleware.SessionMiddleware',
   'django.middleware.locale.LocaleMiddleware',  # LocaleMiddleware 中间件需要放在 sessions 中间件之后和 common 中间件之前
   'django.middleware.common.CommonMiddleware',
]

TEMPLATES = [
    {
        # BACKEND 要使用的模板后端。还有一个 'django.template.backends.jinja2.Jinja2'
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        # DIRS 包含搜索顺序的序列，搜索引擎会按照这个顺序查找 template 资源文件
        'DIRS': [
            os.path.join(BASE_DIR, 'templates').replace('\', '/'),  # 设置项目根目录模板路径
        ]
        ,
        'APP_DIRS': True,  # Templates 引擎是否应该在已安装的 app 中查找 Template 源文件
        'OPTIONS': {
            'context_processors': [
                "django.template.context_processors.i18n",  # 模板国际化
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.template.context_processors.media',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

# LANGUAGE_CODE = 'en-us'
LANGUAGE_CODE = 'zh-hans'

# UTC 世界统一时间
# TIME_ZONE = 'UTC'
TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True  # 启用国际化

USE_L10N = True


# 国际化语言种类
from django.utils.translation import gettext_lazy as _

LANGUAGES = [
    ('en', _('English')),
    ('zh-Hans', _('中文简体')),
]

# 国际化翻译文件目录
LOCALE_PATHS = [
    os.path.join(BASE_DIR, 'locale'),  # 翻译文件所在目录，请手动创建目录
]

　　

安装 gettext

Django 框架具有很好的 I18N 和 L10N 的支持，其实现是基于 GNU 的 gettext, 所以要想在 Django 中使用 I18N 还需要先安装配置 gettext。

windows gettext 下载地址：

https://mlocati.github.io/articles/gettext-iconv-windows.html

exe 包安装时会默认加入到环境变量（提醒：已打开的 cmd 或 控制台，后加入的环境变量不会生效，需要重启咯），如图：

 Mac 安装 gettext 使用 brew 安装：(CommandError: Can't find msguniq. Make sure you have GNU gettext tools 0.15 意思是提示需要安装 gettext）（注：Mac 解决 Homebrew 一直卡在 update）

brew install gettext

brew link gettext --force

　　

生成需要翻译的文件

python manage.py makemessages -l zh_Hans

python manage.py makemessages -l zh_Hans 
# 结果
processing locale zh_Hans

运行成功后会生成一个 django.po 文件（ LOCALE_PATHS 对应语言目录下 - 具体看下图，这个里面就是我们手动写翻译的地方）

django.po 文件：

如果执行命令：python manage.py makemessages -l zh_Hans（第二个 H 大写）

msgid: 需要翻译的文案

msgstr: 翻译后的文案

在代码中看到：_("这种就是国际化的标志，我们只需要翻译下就 OK")

 

最后一步就是 编译

编译成功后会在 django.po 的对应目录生成 django.mo 文件

python manage.py compilemessages

　　

实践效果图

其他用途

• 把三方库某些显示的文案翻译成本地语言，而不用修改源代码。