【Django | 开发】 (国际化项目&支持多语言）

2022-08-11 115

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 【Django | 开发】 (国际化项目&支持多语言）

在这里插入图片描述

该文章收录专栏
✨ ---Django从（图文并茂轻松上手教程）专栏---✨！！
🎏内容：
✨【Djang | 增删改查】学生系统案例✨
✨【Django | 项目搭建】快速搭建自己的项目✨
✨【Django | allauth】登录_注册_邮箱验证_密码邮箱重置✨
✨【Django | allauth】useprofile 用户模型扩展✨
✨【Django | allauth】重写allauth重置密码方法✨
✨【Django | 开发】面试招聘信息网站（快速搭建核心需求）✨
✨【Django | 开发】面试招聘信息网站（增加csv,excel导出&日志管理功能）✨
✨【Django | 开发】面试招聘信息网站（处理产品细节和权限&美化页面样式）✨
✨【Django | 开发】面试招聘信息网站（划分面试官权限&集成钉钉消息）✨
✨【Django | 开发】面试招聘信息网站（用户登录注册&投在线递简历）✨

@[toc]

一、国际化项目介绍

在这里插入图片描述

这个翻译不是浏览器翻译的，Django也不会帮你翻译。这个需要你自己事先手动翻译好，存放在专门翻译文件中，Django只是事后调用而已。

二、实现步骤

2.1 为翻译字符串添加钩子

1) py文件

将需要翻译的字符串统一使用gettext_lazy或gettext包裹

from django.utils.translation import gettext_lazy as _

class Candidate(models.Model):
    # * 基础信息 （对于整形数值一定要定义null=true，因为如果没有赋值，数据库会声明不能为null
    user_id = models.IntegerField(verbose_name=_('应聘者ID'), blank=True, null=True)
    username = models.CharField(max_length=135, verbose_name=_('姓名'))
    city = models.CharField(max_length=135, verbose_name=_('城市'), blank=True)
    phone = models.CharField(max_length=135, verbose_name=_('手机号码'))
    email = models.EmailField(max_length=135, verbose_name=_('邮箱'), blank=True)
    gender = models.CharField(max_length=135, verbose_name=_('性别'), blank=True)
    apply_position = models.CharField(max_length=135, verbose_name=_('应聘职位'), blank=True)
    born_address = models.CharField(max_length=135, verbose_name=_('生源地'), blank=True)
    candidate_remark = models.CharField(max_length=135, blank=True, verbose_name=_('候选人信息备注'))

2）HTML文件

导入i18n，为需要翻译的代码添加代码{% translate %} 或者{% blocktranslate %}（用于存在变量翻译）

{% load i18n %}
                <div class="">
                    <h6 class="uppercase font-semibold mb-4 flex justify-center md:justify-start">
                        {% translate     "Useful links" %}
                    </h6>
                    <p class="mb-4">
                        <a href="#!" class="text-gray-600">{% translate     "Pricing" %}</a>
                    </p>
                    <p class="mb-4">
                        <a href="#!" class="text-gray-600">{% translate     "Settings" %}</a>
                    </p>
                    <p class="mb-4">
                        <a href="#!" class="text-gray-600">{% translate     "Orders" %}</a>
                    </p>
                    <p>
                        <a href="#!" class="text-gray-600">{% translate     "Help" %}</a>

-----------------------------------------------------------------------------------------------
<-- 块翻译 -->
{% blocktranslate with job_name=job.job_name job_city=job.job_place %}
        <h2>岗位名称：{{ job_name }}</h2>
        <div>
        </div>
        <div>
            城市： {{ job_city }}
        </div>
        {% endblock %}

如果在翻译中存在二级变量或者三级变量在渲染时需要提前保存

2.2 生成本地化翻译资源文件

在settings加入如下


# 默认语言
LANGUAGE_CODE = 'zh-hans'

from django.utils.translation import gettext_lazy as _

LANGUAGES = [
    ('en', _('English')),
    ('zh-hans', _('Simplified Chinese')),
]
# 用于存放django.po和django.mo编译过的翻译文件
PROJECT_ROOT = os.path.dirname(os.path.dirname(os.path.realpath(__name__)))
LOCALE_PATHS = (
    os.path.join(PROJECT_ROOT, 'locale'),
)

在项目根目录下生成locale目录，用于保存翻译消息文件(.po和.mo格式的)
在终端输入

( 大坑插入：
由于在gettext版本低于0.15, 报错： Make sure you have GNU gettext tools 0.15 or newer installed.,我花了一整天时间处理😑，由于支持window系统以及配置网上的方法都比较旧，最后还是 stackoverflow香😎，直接在 网址https://mlocati.github.io/articles/gettext-iconv-windows.html下载static 64文件，将其 bin文件 配置到系统环境变量即可！！

django-admin makemessages -l zh_Hans -l en

生成对应文件

在这里插入图片描述

我们需要在对应的文件中，给这些需要翻译的键添加值 ( msgid （message id）是键，msstr(message str)是值。

en 文件

（这里的 en 是之前所设置的名字，需要与setting中语言 配置元组中第一个数据一样，此时我们需要都将中文翻译成英文， 注意！！不进行翻译会默认使用其他语言！，例如在中文对 广州市翻译中翻译成了英文！）

msgid "工作经验"
msgstr "work-experience"

#: .\jobs\models.py:65
msgid "项目经历"
msgstr "product-experience"

#: .\jobs\models.py:75 .\jobs\models.py:76
msgid "简历"
msgstr "resume"

#: .\jobs\views.py:60
msgid "job does not exist"
msgstr "工作不存在"

#: .\recruitment\urls.py:34
msgid "霍格沃兹学院"
msgstr "Hogwarts"

#: .\recruitment\urls.py:36 .\templates\base.html:9
msgid "霍格沃兹招聘信息网"
msgstr "Hogwarts job list"

zh_Hans 文件则翻译为中文

msgstr "忘记密码？"

#: .\templates\account\login.html:71
msgid "Log In"
msgstr "登 录"

#: .\templates\account\login.html:75
msgid "Don't have an account?"
msgstr "还没有账户？"

#: .\templates\account\login.html:75
msgid "Register here."
msgstr "点击注册"

#: .\templates\account\logout.html:9 .\templates\account\logout.html:12
#: .\templates\account\logout.html:21
msgid "Sign Out"
msgstr "注销"

#: .\templates\account\logout.html:14
msgid "Are you sure you want to sign out?"
msgstr "你确定要注销吗"

编译为二进制文件

django-admin compliemessages

在这里插入图片描述

三、配置settings文件

添加路径映射

  path('i18n/', include('django.conf.urls.i18n')),

在settings添加国家化的配置

# 默认语言
LANGUAGE_CODE = 'en-us'

# 设置I18n和L10N为True
USE_I18N = True
USE_L10N = True

from django.utils.translation import gettext_lazy as _

LANGUAGES = [
    # 第一个是对应语言，第二个是字符串表达
    ('en', _('English')),
    ('zh-hans', _('Simplified Chinese')),
]
# 用于存放django.po和django.mo编译过的翻译文件
LOCALE_PATHS = (
    os.path.join(BASE_DIR, 'locale'),
)

效果

可以看到中文都翻译成了自己翻译的英文

在这里插入图片描述

配置本地化中间件

LocaleMiddleware这个中间件。它的位置也很重要，应于 SessionMiddleware之后， CommonMiddleware之前。( 通用中间件前，改中间件主要用于一些简单处理）

MIDDLEWARE = [
    'interview.performance.performance_logger_middleware',
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.locale.LocaleMiddleware', # 新增多语支持
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

四、让用户自己选择语言

1）通过表单修改语言版本

添加下拉框选择语言，在 base.html根模板下修改如下

{#  set language  #}
<form method="POST" action="{% url "set_language" %}">
    {% csrf_token %}
    <input type="hidden" name="next" value="{{ redirect_to }}"/>
    <select name="language">
        {#    得到当前语言#}
        {% get_current_language as LANGUAGE_CODE %}
        {#   可用语言就是setting文件配置的元组 #}
        {% get_available_languages as LANGUAGES %}
        {#   获取可用语言详细信息字典#}
        {% get_language_info_list for LANGUAGES as languages %}
        {% for language in languages %}               {#  复选框默认为当前语言  #}
            <option value="{{ language.code }}" {% if language.code == LANGUAGE_CODE %} selected {% endif %}>
                {{ language.name_local }} {{ language.code }}
            </option>
        {% endfor %}
    </select>
    {% trans "The current language:" %} {{ LANGUAGE_CODE }}
    <button type="submit">{% trans "Switch" %}</button>
</form>

我还想美化他的样式和django文档一样

在这里插入图片描述

实现代码如下(使用的样式是tailwind)

{#  set language  #}
<div class="fixed bottom-0 right-0 mb-3 xl:w-96">
    <form method="POST" action="{% url "set_language" %}" class="my-2  p-1 flex   rounded svelte-1l8159u">
        {% csrf_token %}
        <input type="hidden" name="next" value="{{ redirect_to }}"/>

        <select name="language" class="form-select form-select-sm
    appearance-none
    block
    w-full
    px-2
    py-1
    text-sm
    font-normal
    text-gray-700
    bg-white bg-clip-padding bg-no-repeat
    border border-solid border-gray-300
    rounded
    transition
    ease-in-out
    m-0
    focus:text-gray-700 focus:bg-blue focus:border-blue-600 focus:outline-none">
            {# 得到当前语言#}
            {% get_current_language as LANGUAGE_CODE %}
            {#   可用语言就是setting文件配置的元组 #}
            {% get_available_languages as LANGUAGES %}
            {#   获取可用语言详细信息字典#}
            {% get_language_info_list for LANGUAGES as languages %}
            {% for language in languages %}               {#  复选框默认为当前语言  #}
                <option value="{{ language.code }}" {% if language.code == LANGUAGE_CODE %} selected {% endif %}>
                    {% trans "The current language:" %} {{ language.name_local }} {{ language.code }}
                </option>
            {% endfor %}
        </select>
        <button type="submit" class="inline-block px-4 py-1.5 bg-blue-600 text-white font-medium text-xs leading-tight uppercase rounded shadow-md hover:bg-blue-700 hover:shadow-lg focus:bg-blue-700 focus:shadow-lg focus:outline-none focus:ring-0 active:bg-blue-800 active:shadow-lg transition duration-150 ease-in-out">{% trans "Switch" %}</button>
    </form>
</div>

效果

在这里插入图片描述

2）通过对应链接修改

其实 django官方文档的国家化项目中也是这么干的

这里需要添加路由url i18n_patterns

from django.contrib import admin
from django.urls import path, include
from django.conf.urls.i18n import i18n_patterns


urlpatterns = [
    path('i18n/', include('django.conf.urls.i18n')),
]


urlpatterns += i18n_patterns(
    path('admin/', admin.site.urls),
    path('', include('myapp.urls')),
)

这样在不同路径下，就会切换语言，但是目前是需要全部项目的路由都要修改，不知道如何配置才不需要😂（参考文章：大江狗 | 刘江的博客）

小结

Django如何识别用什么语言呢？

django查询语言是 先从url找，然后再从cookie里面找，再从浏览器header里面找，如果都没有的话则 使用系统默认语言LANGUAGE_CODE

Django如何切换语言？

在切换语言from表单中，我们所提交的表单路径 set_language 是我们所导入 i18n url 路径所提供的， 提交的language.code能够对应到我们所设置的语言就能切换语言。

                    🤞到这里，如果还有什么疑问🤞
        🎩欢迎私信博主问题哦，博主会尽自己能力为你解答疑惑的！🎩
            🥳如果对你有帮助，你的赞是对博主最大的支持！！🥳

【Django | 开发】 (国际化项目&支持多语言）

一、国际化项目介绍

二、实现步骤

2.1 为翻译字符串添加钩子

1) py文件

2）HTML文件

2.2 生成本地化翻译资源文件

三、配置settings文件

四、让用户自己选择语言

1）通过表单修改语言版本

2）通过对应链接修改

小结

热门文章

最新文章

相关课程

相关电子书

相关实验场景

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

【Django | 开发】 (国际化项目&支持多语言）

一、国际化项目介绍

二、实现步骤

2.1 为翻译字符串添加钩子

1) py文件

2）HTML文件

2.2 生成本地化翻译资源文件

三、配置settings文件

四、让用户自己选择语言

1） 通过表单修改语言版本

2）通过对应链接修改

小结

热门文章

最新文章

相关课程

相关电子书

相关实验场景

1）通过表单修改语言版本