2025年3月31日 星期一 乙巳(蛇)年 正月初一 设为首页 加入收藏
rss
您当前的位置:首页 > 计算机 > 编程开发 > Python

Django国际化

时间:06-21来源:作者:点击数:51

安装python环境并配置系统变量

安装django :pip install Django

CMD中输入django-admin看看是否有命令提示输出,如果没有,

将”xxxxx\Roaming\Python\Python39\Scripts”加入环境变量

创建项目:django-admin.py startproject 项目名

项目目录下:cd 项目名

创建应用:python manage.py startapp 应用名

在myproject目录下新建locale文件夹,用于保存翻译消息文件(.po和.mo格式的)

此时文件目录如下:

修改配置文件settings.py

  • #高版本django 导入
  • from django.utils.translation import gettext_lazy as _
  • #低版本django导入
  • from django.utils.translation import ugettext_lazy as _

#加入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",
  • ]
  • LANGUAGE_CODE = "en"
  • TIME_ZONE = "UTC"
  • USE_I18N = True
  • USE_TZ = True
  • # 指定支持语言。这里为了简化只支持简体中文和英文
  • LANGUAGES = (
  • ('en', _('English')),
  • ('zh-hans', _('Simplified Chinese')),
  • )
  • # 用于存放django.po和django.mo编译过的翻译文件
  • PROJECT_ROOT = os.path.dirname(os.path.realpath(__name__))
  • LOCALE_PATHS = (
  • os.path.join(PROJECT_ROOT, 'locale'),
  • )

修改urls.py, 增加国际化i18n的支持

  • from django.contrib import admin
  • from django.urls import path, include
  • from django.conf.urls.i18n import i18n_patterns
  • from django.urls import path
  • from .views import 需要应用的函数方法
  • from django.urls import path
  • urlpatterns = [
  • path('i18n/', include('django.conf.urls.i18n')),
  • ]
  • urlpatterns += i18n_patterns(
  • path('admin/', admin.site.urls),
  • path('', 需要应用的函数方法),
  • )

此时访问

127.0.0.1:8000/en/admin

127.0.0.1:8000/zh-hans/

应该是可以看到中文/英文的管理界面

# settings文件中加入templates文件夹,并新建index.html文件

#"DIRS": [os.path.join(BASE_DIR, 'templates')],

  • TEMPLATES = [
  • {
  • "BACKEND": "django.template.backends.django.DjangoTemplates",
  • "DIRS": [os.path.join(BASE_DIR, 'templates')],
  • "APP_DIRS": True,
  • "OPTIONS": {
  • "context_processors": [
  • "django.template.context_processors.debug",
  • "django.template.context_processors.request",
  • "django.contrib.auth.context_processors.auth",
  • "django.contrib.messages.context_processors.messages",
  • ],
  • },
  • },
  • ]

Django支持在python文件,html和txt文本文件中标记需要翻译的字符串。

<9.1.在python文件中(比如models.py和views.py)使用ugettext_lazy(gettext_lazy)方法

<9.2.在html和txt文件中使用{% trans "string" %}和{% blocktrans%} {%endblocktrans %}标签,

<9.3.使用前需在文件开头加入{% load i18n %}

以上1,2,3模板的使用举例如下,具体使用可自行扩展:

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">
  • <title>Django</title>
  • </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"></a>
  • <form class="form-inline ml-3-md" action="{% url 'set_language' %}" method="post">
  • {% csrf_token %}
  • <div class="input-group">
  • <input name="next" type="hidden" value="{{ redirect_to }}" />
  • <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-warning">
  • {% 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 'Current language code' %}: {{ LANGUAGE_CODE }}</b> </h4>
  • <p><small>{% trans "Welcome to our page" %}</small></p>
  • <hr/>
  • <p>{% blocktrans %} {{ msg }} {% endblocktrans %}</p>
  • </div>
  • </div>
  • {% endblock %}

进入项目下/views.py

#通过gettext()函数指定需要翻译的字符串

  • from django.shortcuts import render
  • # Create your views here.
  • from django.http import HttpResponse
  • from django.shortcuts import render
  • from django.template import RequestContext
  • from django.utils.translation import gettext_lazy as _
  • def index(request):
  • context = {'msg': _("Welcome to China")}
  • return render(request, 'index.html', context)

{% load i18n %}以后,可以使用get_current_language标签获得当前语言。

在模板中分别使用{% trans "string" %}和{% blocktrans%} {%endblocktrans %}标签来标记了两个需要翻译的字符串,

一个是模板中已存在的,一个是视图函数传递过来的变量。

以上完成后需要对前面标记的字符串进行手动翻译,并生成编译过后的消息文件供Django使用

<trans不能实现自动翻译,还需要编译相关文件>

此时文件目录如下:

在win环境下需要先提前安装GNU gettext工具

在win环境下需要先提前安装GNU gettext工具

在win环境下需要先提前安装GNU gettext工具

地址:https://mlocati.github.io/articles/gettext-iconv-windows.html,下载成功后直接双击exe文件安装,一直点击下一步直至安装成功即可。

建立消息文件是通过django-admin makemessages命令完成的。

在项目的根目录下,也就是包含manage.py的目录下,运行下面的命令:

  • python manage.py makemessages -l zh_HANS //中文简体
  • python manage.py makemessages -l en //英文

或:

  • django-admin makemessages -l zh_HANS
  • django-admin makemessages -l en

此时文件路径如下:

每个.po文件首先包含一小部分元数据,例如翻译维护者的联系信息,但文件的大部分是翻译对照:被翻译字符串和特定语言的实际翻译文本之间的简单映射。

例如,有一个像下面这样的待翻译字符串:

_("Welcome to my site.")

在.po文件中将包含一条下面样子的条目:

  • #: path/to/python/module.py:23
  • msgid "Welcome to my site."
  • msgstr ""

这三行内容各自代表下面的意思:

  • 第一行通过注释表达该条要翻译的字符串在视图或模版中的位置;
  • msgid:要翻译的字符串。不要修改它。
  • msgstr:翻译后的文本。一开始它是空的,需要翻译人员逐条填写。

这是一个文本文件,需要专业的翻译人员将所有的msgstr空白‘填写’齐全。

  1. 编译消息文件

当完成消息文件的创建和翻译工作后,或者对文件修改后,需要将其编译成对应的*.mo文件,Django在运行时将使用*.mo文件对网站进行国际化翻译。

进入项目根目录,运行下面的命令,进行语言文件编译:

  • django-admin compilemessages

此时文件路径如下:

国际化和本地化就完成了

方便获取更多学习、工作、生活信息请关注本站微信公众号城东书院 微信服务号城东书院 微信订阅号
推荐内容
相关内容
栏目更新
栏目热门