安装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 ""
这三行内容各自代表下面的意思:
这是一个文本文件,需要专业的翻译人员将所有的msgstr空白‘填写’齐全。
当完成消息文件的创建和翻译工作后,或者对文件修改后,需要将其编译成对应的*.mo文件,Django在运行时将使用*.mo文件对网站进行国际化翻译。
进入项目根目录,运行下面的命令,进行语言文件编译:
django-admin compilemessages
此时文件路径如下:
国际化和本地化就完成了