django支持多语言

Django支持多语言切换

下面介绍下如何使网站或APP国际化，让其支持多种语言。

效果

1、创建locale文件夹

先在项目根目录下创建一个名为locale的文件夹，这个文件夹是用来存放django.po和django.mo编译过的翻译文件。下面是我的项目文件夹示例：

2、settings.py中配置

首先配置中间件，添加LocaleMiddleware，放在SessionMiddleware后面，CommonMiddleware前面，

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',

]

配置支持多语言：

from django.utils.translation import ugettext_lazy as _

LANGUAGE_CODE = 'zh-hans'  # 默认使用中国时区

TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True

USE_L10N = True

USE_TZ = True

LANGUAGES = (

    ('en', _('English')),

    ('zh-hans', _('Simplified Chinese')),

)

# 用于存放django.po和django.mo编译过的翻译文件

LOCALE_PATHS = (os.path.join(BASE_DIR, 'locale'),)

3、设置urls.py

在项目中的路由配置urls.py中设置i18n多语言路由。

from django.conf.urls.i18n import i18n_patterns

from django.contrib import admin

from django.urls import path, re_path, include

from django.views.static import serve

from mallSystem import settings

urlpatterns = [

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

]

urlpatterns += i18n_patterns(

    path('admin/', admin.site.urls),

    path("", include("mall.urls")),

    re_path(r'^static/(?P<path>.*)$', serve, {'document_root': settings.STATICFILES_DIRS}),

)

注：i18n是国际化(Internationalization)的缩写。i 和 n 之间有 18 个字母，简称 i18n,。l10n是本地化(localization)的缩写。l 和 n 之间有 10 个字母，简称 l10n。

4、访问admin

现在就可以通过不同的语言来访问后台管理网站了，

中文：http://127.0.0.1:8001/zh-hans/admin/login/

英文：http://127.0.0.1:8001/en/admin/login/

5、翻译py、html中的字符串

在py文件中使用函数ugettext_lazy 。

在html中使用标签{% trans “string” %}或{% blocktrans%} {%endblocktrans %} ，需在文件开头加入{% load i18n %} 表示使用多语言。

下面是翻译的一个示例。通过访问url来得到不同语言的html。

apps/mall/urls.py

from django.urls import path

from mall import views

urlpatterns = [

    path("", views.index, name="index"),  # 首页

]

apps/mall/views.py

from django.shortcuts import render

from django.utils.translation import ugettext_lazy as _

def index(request):

    context = {'msg': _("这是一个有趣的购物网站，你可以在这里购买都衣服、手提包、鞋子等等")}

    return render(request, 'index.html', context)

templates/index.html

<!DOCTYPE html>

{% load static %}

{% load i18n %}

<html lang="en">

<head>

    <meta charset="utf-8">

    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">

    <meta name="description"

          content="Quickly get a project started with any of our examples ranging from using parts of the framework to custom components and layouts.">

    <title>{% trans "购物网站" %}</title>

    <link rel="canonical" href="https://getbootstrap.com/docs/4.5/examples/">

    <link href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.0/css/bootstrap.min.css" rel="stylesheet"

          integrity="sha384-9aIt2nRpC12Uk9gS9baDl411NQApFmC26EwAOH8WgZl5MYYxFfc+NcPb1dKGj7Sk" crossorigin="anonymous">

    <style>

        body {

            overflow-x: hidden; /* Prevent scroll on narrow devices */

            font-family: 'Inter', Arial, sans-serif;

            background: #F6F8FF;

            padding-top: 56px;

        }

        .form-control{

            margin-right: 10px;

        }

    </style>

</head>

<body>

{#多语言切换下拉框#}

<nav class="navbar navbar-expand-md fixed-top navbar-light box-shadow bg-white">

    <div class="container">

        <a class="navbar-brand align-items-md-center" href="index.html">{% trans "Django多语言切换" %}</a>

        <form class="form-inline ml-3-md" action="{% url 'set_language' %}" method="post">

            {% csrf_token %}

            <div class="input-group">

                <select name="language" class="form-control">

                    {% get_current_language as LANGUAGE_CODE %}

                    {% 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 }}

                        </option>

                    {% endfor %}

                </select>

                <div class="input-group-append">

                    <button type="submit" class="btn btn-inline btn-sm bg-success">

                        {% trans "Select" %}

                    </button>

                </div>

            </div>

        </form>

    </div>

</nav>

{% block content %}

    <div class="py-4 px-3 bg-light">

        <div class="container">

            {% get_current_language as LANGUAGE_CODE %}

            <h4>{% trans '当前语言' %}: <b>{{ LANGUAGE_CODE }}</b></h4>

            <p><small>{% trans "这是一个购物网站" %}</small></p>

            <hr/>

            <p>{% blocktrans %} {{ msg }} {% endblocktrans %}</p>

        </div>

    </div>

{% endblock %}

<footer class="bd-footer bg-light">

    <div class="container pt-3 pb-2 px-3 px-md-2">

        <ul class="bd-footer-links list-unstyled text-muted list-inline pb-2">

            <li class="list-inline-item">

                <small>© {% trans '开发者 LDC' %}</small>

            </li>

            <li class="list-inline-item">

                <small>{% trans '联系方式: 微信 1257309054' %}</small>

            </li>

        </ul>

    </div>

</footer>

<script src="https://lib.baomitu.com/jquery/3.5.0/jquery.js"></script>

<script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.0/dist/umd/popper.min.js"></script>

<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.0/js/bootstrap.min.js"></script>

</body>

</html>

可以通过get_current_language获取当前语言。

6、生成po、mo翻译文件

如果是windows系统，需要先下载gettext，

下载方式一：官网

下载方式二：关注公众号“轻松学编程”，回复gettext即可。

下载gettext后解压缩到C盘, C:\Program Files (x86)\gettext，复制C:\Program Files (x86)\gettext\bin路径加入到系统PATH的环境变量(在控制面板>系统>高级>环境变量中添加)

在项目根目录中打开cmd窗口，激活虚拟环境，然后运行以下命令生成po文件：

# 生成中文的po文件

python manage.py makemessages -l zh_HANS    

# 生成英文的po文件

python manage.py makemessages -l en

如果生成成功，那么在locale文件夹中可以看到以下文件：

翻译好每一个msgstr后，就需要生成mo文件，命令为：

python manage.py compilemessages

然后打开浏览器，输入http://127.0.0.1:8001/zh-hans/，就可以看到中文html，

输入http://127.0.0.1:8001/en/就可以看到英文的html了，当然也可以通过下拉框来进行切换。

后记

【后记】为了让大家能够轻松学编程，我创建了一个公众号【轻松学编程】，里面有让你快速学会编程的文章，当然也有一些干货提高你的编程水平，也有一些编程项目适合做一些课程设计等课题。

也可加我微信【1257309054】，拉你进群，大家一起交流学习。
如果文章对您有帮助，请我喝杯咖啡吧！

公众号

关注我，我们一起成长~~